📃
Finema Documentation
  • Introduction to SSI
  • IDIN Platform
  • IDIN Key Management
  • API Tutorials
    • DID API
      • DID Registration
      • Key Series Addition
      • Key Series Revocation
      • Resetter Registration
      • Resetter Revocation
      • Resetter Approval
      • GET DID Nonce
    • VC API
      • VC Registration
      • VC Revocation
      • GET VC Verification Key
Powered by GitBook
On this page
  • Overview
  • Types of Requests

Was this helpful?

  1. API Tutorials

VC API

PreviousGET DID NonceNextVC Registration

Last updated 4 years ago

Was this helpful?

Overview

The VC API provides a collection of request methods that involves Verifiable Credentials (VCs). This API allows a credential issuer to register a new VC with the vc_register operation or revoke an exisiting VC the vc_revoke operation. When a credential holder presents a VC to a credential verifier, the verifier could then obtain the VC's verification key with a GET request.

In the same way as the , HTTP requests to a IDIN server must be in the JSON format with two attributes "message" and "signature". One distinction to the DID API is the GET method for a VC's verification key that requires no request body.

{
    "message": "eyJjdXJyZW50X2tleSI6ICItLS0tLUJFR0lOIFBVQkxJQyBLRVktLS0tLVxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFdDBha0ZjUXE2eklacXpXV3FHY01mMUxIRXNtTVxuanlyb2Vla0lVbVZkRnkzMTVsZHhjbjJmUHpQcXlqSlZvbEpSdm9SYVZvWlpaalpDQnp5NHlBU3hxdz09XG4tLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0iLCAibmV4dF9rZXlfaGFzaCI6ICI1MThiN2U5ZTRmY2EzNjVkZmY3YjZmNmQ0NTA5YmJlMjk5MDAzN2E4OGQ3NjMzZWYwZmFhYWRlYmEzNTEyM2VkIiwgIm9wZXJhdGlvbiI6ICJ2Y19yZWdpc3RlciIsICJkaWRfYWRkcmVzcyI6ICJkaWQ6aWRpbjphZmI3YmE4OGM3NmVkYmRhNTVjMzQ0YjcwYWUwY2YwNTU2ZDc3MGVjMjU2ODIwZDcxODUwMDBkZTM5NTM5MWI1IiwgIm5vbmNlIjogNX0=",
    "signature": "MEUCIFSbmMEUcyjSYwq4QOXWZewn+xS/Jih04DRGKwNKlkQnAiEAuH3Es1opQ3LTTYbwyTJylskbaZOl7vSAF9RFp2Qn3TI="
}

Types of Requests

The table below summarizes all VC-related HTTP requests to the IDIN server.

Request Method

Description

HTTP Method

Register a new VC.

POST

Revoke a VC.

DELETE

Get a verification key of a VC.

GET

HTTP
DID API
vc_register
vc_revoke