API Reference

KryptoOS provides a suite of RESTful APIs to facilitate integration across different platforms and languages.

Issuer API

The Issuer API handles the creation and signing of Verifiable Credentials.

POST /v1/issuer/vc/issue

Issues a new verifiable credential.

Request Body:

{
  "credential": {
    "@context": ["https://www.w3.org/2018/credentials/v1"],
    "type": ["VerifiableCredential", "ProofOfAge"],
    "credentialSubject": {
      "id": "did:emp:user-123",
      "over18": true
    }
  },
  "options": {
    "proofType": "Ed25519Signature2020",
    "expirationDate": "2025-01-01T00:00:00Z"
  }
}

Verifier API

The Verifier API validates the authenticity and status of credentials and presentations.

POST /v1/verifier/vc/verify

Verifies a single verifiable credential.

POST /v1/verifier/vp/verify

Verifies a verifiable presentation (collection of credentials).

Resolver API

The Resolver API retrieves DID Documents from the EmpoorioChain.

GET /v1/resolver/did/:did

Resolves a DID to its corresponding DID Document.

Example: GET /v1/resolver/did/did:emp:1234abcd

Security

All production API calls must include an Authorization header with a valid API Key.

Authorization: Bearer YOUR_API_KEY

For security best practices, refer to the Privacy & Security guide.