API Reference
Create a Certificate Authority
Creates a Certificate Authority (CA) identifier (DID) and a new wallet address.
POST
'https://demo.eidcmp.wallid.io/api/v1/ca/
Headers
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
Request Body
Name | Type | Description |
---|---|---|
| string | wallet address |
| string | registered email address of the account admin |
Example Request
Example Response
Create a Template
Creates a Certificate template as achema with fixed attributes and corresponding dynamic attestations.
POST
'https://demo.eidcmp.wallid.io/api/v1/template/
Headers
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
Request Body
Name | Type | Description |
---|---|---|
| string | CA identifier |
| string | Name of the Template |
| string | CA wallet address |
| object | frontend elements and attributes of the certificate schema. Contains |
| object | contains all the visual and atribute elements of the certificate |
| string | type of certificate visual format (card, badge, vertical A4, horizontal H4) |
Example Request
Component Object elements
Name | Type | Description |
---|---|---|
| string | |
| string | |
| string | |
| string | |
| object | |
| string | |
| string | |
| string | |
| string | |
| string | |
| string | |
| boolean | |
| boolean | |
| number | |
| number | |
| (string | undefined)[] | |
| string | |
| string | |
| string | |
| boolean |
Styles object elements:
Name | Type | Description |
---|---|---|
| string | |
| string | |
| string | |
| string | |
| string | number | |
| string | |
| string | |
| string | |
| boolean | |
| boolean | |
| boolean | |
| string | |
| number | |
| number | |
| string |
Example Response
Other Template Related Requests
Get Template
Returns the certificate template json file
GET
'https://demo.eidcmp.wallid.io/api/v1/template/:tid
Get Template File
Returns a the certificate template file in the specified file format (eg. .csv or .xls)
GET
'https://demo.eidcmp.wallid.io/api/v1/template/:tid/download/:fileFormat
Delete Template
Deletes Template from the API
DELETE
'https://demo.eidcmp.wallid.io/api/v1/template/:tid
Issue Certificates
Issues new certificate to and sends it to the a recipient email address.
POST
'https://demo.eidcmp.wallid.io/api/v1/credential/create
Headers
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
Request Body
Name | Type | Description |
---|---|---|
| string | CA identifier |
| string | Template identifier |
| string | CA wallet address |
| dictionary | object with data to be stored in the credential (in the format of a list of "key": "value" pairs) |
| string | recipient person email address |
Example Request
Example Response
Verify Certificates
Creates a verification URL to get and display certificate and verification data.
POST
'https://demo.eidcmp.wallid.io/api/v1/credential/create-verify-url
Headers
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
Request Body
Name | Type | Description |
---|---|---|
| string | Certificate identifier |
| string | Template identifier |
| string | a unique identifier for the verification session and is returned in the init method |
Example Request
Example Response
Other Verification Related Requests
Redirect Verification Session
Triggers socket io event in the Verify page session
GET
'https://demo.eidcmp.wallid.io/api/v1/credential/redirect/:sessionId
Get Certificate data
Gets certificate data for the session in the OIDC format
GET
'https://demo.eidcmp.wallid.io/api/v1/credential/data/:sessionId
Last updated