Presentation Template

Entity Studio SSI API base URL: https://api.entity.hypersign.id

post

/api/v1/presentation/template

Authorizations

Header parameters

Authorizationstring

Bearer <access_token>

Originstring

Origin as you set in application cors

Body

domainstringrequired

Domain name

Example: fyre.hypersign.id

namestringrequired

name of the presentation template

Example: alumni_credential_request (sanke_case)

queryobject[]required

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/presentation/template' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "domain": "fyre.hypersign.id",
    "name": "alumni_credential_request (sanke_case)",
    "query": [
      {
        "type": "QueryByExample / DIDAuthentication",
        "credentialQuery": [
          {
            "required": true,
            "reason": "We need you to prove your eligibility to work.",
            "example": {
              "type": "AlumniCredential",
              "@context": [
                "https://www.w3.org/2018/credentials/v1"
              ],
              "credentialSubject": {
                "name": "Random name",
                "id": "did:hid:testnet:............................."
              },
              "credentialSchema": {
                "id": "sch:hid:testnet:...............",
                "type": "JsonSchemaValidator2018"
              },
              "trustedIssuer": [
                {
                  "required": true,
                  "issuer": "did:hid:testnet:................"
                }
              ]
            }
          }
        ]
      }
    ]
  }'

201

400

201

{
  "domain": "fyre.hypersign.id",
  "name": "alumni_credential_request (sanke_case)",
  "query": [
    {
      "type": "QueryByExample / DIDAuthentication",
      "credentialQuery": [
        {
          "required": true,
          "reason": "We need you to prove your eligibility to work.",
          "example": {
            "type": "AlumniCredential",
            "@context": [
              "https://www.w3.org/2018/credentials/v1"
            ],
            "credentialSubject": {
              "name": "Random name",
              "id": "did:hid:testnet:............................."
            },
            "credentialSchema": {
              "id": "sch:hid:testnet:...............",
              "type": "JsonSchemaValidator2018"
            },
            "trustedIssuer": [
              {
                "required": true,
                "issuer": "did:hid:testnet:................"
              }
            ]
          }
        }
      ]
    }
  ]
}

presentaion template Created

get

/api/v1/presentation/template

Authorizations

Query parameters

pagenumber · default: 1

Page value

limitnumber · default: 10

Fetch limited list of data

Header parameters

Authorizationstring

Bearer <access_token>

Originstring

Origin as you set in application cors

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/presentation/template' \
  --header 'Authorization: Bearer JWT'

200

404

200

{
  "totalCount": 12,
  "data": [
    {
      "appId": "43...18-...........",
      "domain": "fyre.hypersign.id",
      "query": [
        {
          "type": "QueryByExample",
          "credentialQuery": [
            {
              "required": true,
              "reason": "We need you to prove your eligibility to work.",
              "example": {
                "type": "AlumniCredential",
                "@context": [
                  "https://www.w3.org/2018/credentials/v1"
                ],
                "credentialSubject": {
                  "name": "Random name",
                  "id": "did:hid:testnet:............................."
                },
                "credentialSchema": {
                  "id": "sch:hid:testnet:...............",
                  "type": "JsonSchemaValidator2018"
                },
                "trustedIssuer": [
                  {
                    "required": true,
                    "issuer": "did:hid:testnet:................"
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}

List of presentation template

get

/api/v1/presentation/template/{templateId}

Authorizations

Path parameters

templateIdstringrequired

Header parameters

Authorizationstring

Bearer <access_token>

Originstring

Origin as you set in application cors

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/presentation/template/{templateId}' \
  --header 'Authorization: Bearer JWT'

200

404

200

{
  "appId": "43...18-...........",
  "domain": "fyre.hypersign.id",
  "query": [
    {
      "type": "QueryByExample",
      "credentialQuery": [
        {
          "required": true,
          "reason": "We need you to prove your eligibility to work.",
          "example": {
            "type": "AlumniCredential",
            "@context": [
              "https://www.w3.org/2018/credentials/v1"
            ],
            "credentialSubject": {
              "name": "Random name",
              "id": "did:hid:testnet:............................."
            },
            "credentialSchema": {
              "id": "sch:hid:testnet:...............",
              "type": "JsonSchemaValidator2018"
            },
            "trustedIssuer": [
              {
                "required": true,
                "issuer": "did:hid:testnet:................"
              }
            ]
          }
        }
      ]
    }
  ]
}

Presentation template detail

patch

/api/v1/presentation/template/{templateId}

Authorizations

Path parameters

templateIdstringrequired

Header parameters

Authorizationstring

Bearer <access_token>

Originstring

Origin as you set in application cors

Body

domainstring

Domain name

Example: fyre.hypersign.id

namestring

name of the presentation template

Example: alumni_credential_request (sanke_case)

queryobject[]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '/api/v1/presentation/template/{templateId}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "domain": "fyre.hypersign.id",
    "name": "alumni_credential_request (sanke_case)",
    "query": [
      {
        "type": "QueryByExample / DIDAuthentication",
        "credentialQuery": [
          {
            "required": true,
            "reason": "We need you to prove your eligibility to work.",
            "example": {
              "type": "AlumniCredential",
              "@context": [
                "https://www.w3.org/2018/credentials/v1"
              ],
              "credentialSubject": {
                "name": "Random name",
                "id": "did:hid:testnet:............................."
              },
              "credentialSchema": {
                "id": "sch:hid:testnet:...............",
                "type": "JsonSchemaValidator2018"
              },
              "trustedIssuer": [
                {
                  "required": true,
                  "issuer": "did:hid:testnet:................"
                }
              ]
            }
          }
        ]
      }
    ]
  }'

200

400

200

{
  "appId": "43...18-...........",
  "domain": "fyre.hypersign.id",
  "query": [
    {
      "type": "QueryByExample",
      "credentialQuery": [
        {
          "required": true,
          "reason": "We need you to prove your eligibility to work.",
          "example": {
            "type": "AlumniCredential",
            "@context": [
              "https://www.w3.org/2018/credentials/v1"
            ],
            "credentialSubject": {
              "name": "Random name",
              "id": "did:hid:testnet:............................."
            },
            "credentialSchema": {
              "id": "sch:hid:testnet:...............",
              "type": "JsonSchemaValidator2018"
            },
            "trustedIssuer": [
              {
                "required": true,
                "issuer": "did:hid:testnet:................"
              }
            ]
          }
        }
      ]
    }
  ]
}

Template Updated

delete

/api/v1/presentation/template/{templateId}

Authorizations

Path parameters

templateIdstringrequired

Header parameters

Authorizationstring

Bearer <access_token>

Originstring

Origin as you set in application cors

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/api/v1/presentation/template/{templateId}' \
  --header 'Authorization: Bearer JWT'

200

404

200

{
  "appId": "43...18-...........",
  "domain": "fyre.hypersign.id",
  "query": [
    {
      "type": "QueryByExample",
      "credentialQuery": [
        {
          "required": true,
          "reason": "We need you to prove your eligibility to work.",
          "example": {
            "type": "AlumniCredential",
            "@context": [
              "https://www.w3.org/2018/credentials/v1"
            ],
            "credentialSubject": {
              "name": "Random name",
              "id": "did:hid:testnet:............................."
            },
            "credentialSchema": {
              "id": "sch:hid:testnet:...............",
              "type": "JsonSchemaValidator2018"
            },
            "trustedIssuer": [
              {
                "required": true,
                "issuer": "did:hid:testnet:................"
              }
            ]
          }
        }
      ]
    }
  ]
}

Template Deleted Successfully