API Documentation

Integrate Solay39 certificate verification into your applications

API Overview

The Solay39 Verification API allows you to programmatically verify certificate authenticity

Base URL

https://www.solay39.eu//api/v1

Authentication

All API requests require an API key. Contact our support team to obtain your API key.

Header: x-api-keyQuery: apiKey

POST/verify

Verify a certificate hash with detailed response

Request Body

{
  "hash": "a1b2c3d4e5f67890abcdef1234567890abcdef12",
  "apiKey": "your-api-key-here",
  "source": "your-app-name" // optional
}

Success Response (200)

{
  "success": true,
  "valid": true,
  "verification_id": "ver_abc123def456",
  "timestamp": "2024-01-15T10:30:00Z",
  "certificate": {
    "hash": "a1b2c3d4e5f67890abcdef1234567890abcdef12",
    "project_name": "DeFi Yield Protocol",
    "audit_id": "audit_001",
    "audit_date": "2024-01-15T10:30:00Z",
    "security_score": 92,
    "risk_level": "Low",
    "vulnerabilities_count": 3,
    "certificate_type": "professional-audit",
    "issuer": "Solay39 Professional Security Audit",
    "tools_used": ["Slither", "Mythril", "Echidna"],
    "findings_summary": {
      "critical": 0,
      "high": 1,
      "medium": 2,
      "low": 0
    },
    "ai_analysis_available": true,
    "monitoring_active": true
  }
}

Error Response (404)

{
  "success": false,
  "valid": false,
  "hash": "invalid-hash",
  "verification_id": "ver_abc123def456",
  "timestamp": "2024-01-15T10:30:00Z",
  "error": "Certificate not found or invalid",
  "code": "CERTIFICATE_NOT_FOUND"
}

GET/verify

Simple certificate verification via query parameters

Query Parameters

hashCertificate hash to verify (required)

apiKeyYour API key (required)

Example Request

GET /api/v1/verify?hash=a1b2c3d4e5f67890abcdef1234567890abcdef12&apiKey=your-api-key

Error Codes

UNAUTHORIZED

Invalid or missing API key

401

MISSING_HASH

Certificate hash is required

400

CERTIFICATE_NOT_FOUND

Certificate hash not found in database

404

INTERNAL_ERROR

Server error during verification

500

Code Examples

JavaScript/Node.js

const response = await fetch('https://www.solay39.eu//api/v1/verify', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your-api-key-here'
  },
  body: JSON.stringify({
    hash: 'a1b2c3d4e5f67890abcdef1234567890abcdef12',
    source: 'my-app'
  })
});

const result = await response.json();
console.log(result.valid ? 'Certificate is valid!' : 'Certificate not found');

Python

import requests

response = requests.post('https://www.solay39.eu//api/v1/verify', 
  headers={'x-api-key': 'your-api-key-here'},
  json={
    'hash': 'a1b2c3d4e5f67890abcdef1234567890abcdef12',
    'source': 'my-python-app'
  }
)

result = response.json()
print('Valid!' if result['valid'] else 'Invalid!')

cURL

curl -X POST 'https://www.solay39.eu//api/v1/verify' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: your-api-key-here' \
  -d '{
    "hash": "a1b2c3d4e5f67890abcdef1234567890abcdef12",
    "source": "curl-test"
  }'

Need Help?

Contact our support team to get your API key or if you need assistance integrating our verification API.