VICAL

Specifies paths and operations for publishing and retrieving an ecosystem policy as a VICAL.

Create VICAL

Creates a Verified Issuer Certificate Authority List (VICAL) based on the policy of the requested ecosystem. Refer to VICAL ot learn more about the VICAL purpose and data structure.

Roles: ["Admin","DTS Provider"]

SecuritybearerAuth

Request

path Parameters

ecosystemId

required

string <uuid>

The UUID of the ecosystem

Example: 87880d7e-a4d0-462e-8383-3f1e5e16865d

Responses

201

VICAL created

500

Internal Server Error. An unexpected error occurred.

post/v1/ecosystems/{ecosystemId}/vicals

Request samples

Response samples

201

application/json

{"vicalIssueID": 1337,
"date": "2024-07-28T23:01:13.000Z"
}

Retrieve all VICALs

Retrieves all VICALs available in the requested ecosystem.

Roles: ["Admin","DTS Provider"]

Request

path Parameters

ecosystemId

required

string <uuid>

The UUID of the ecosystem

Example: 87880d7e-a4d0-462e-8383-3f1e5e16865d

query Parameters

limit	number [ 1 .. 1000 ] Default: 100 Range size of returned list. Example: limit=2
cursor	string Starting point for the list of entries. Example: cursor=Y3JlYXRlZEF0PTIwMjAtMDgtMjVUMDY6NDY6MDkuNTEwWiZpZD1h

Responses

200

VICALs retrieved

404

Not Found. The specified resource was not found.

get/v1/ecosystems/{ecosystemId}/vicals/public

Request samples

Response samples

200
404

application/json

{"data": [{"vicalIssueID": 1337,
"date": "2024-07-28T23:01:13.000Z",
"filename": "vical-2024-07-28-1722164473000.cbor"
}
],
"nextCursor": "Y3JlYXRlZEF0PTIwMjAtMDgtMjVUMDY6NDY6MDkuNTEwWiZpZD1hNjZmZmVhNS04NDhlLTQzOWQtODBhNC1kZGE1NWY1M2UzNmM"
}

Retrieve latest VICAL

Retrieves the latest VICAL from the requested ecosystem.

Request

path Parameters

ecosystemId

required

string <uuid>

The UUID of the ecosystem

Example: 87880d7e-a4d0-462e-8383-3f1e5e16865d

Responses

200

VICAL retrieved

404

Not Found. The specified resource was not found.

get/v1/ecosystems/{ecosystemId}/vicals/public/latest

Request samples

Response samples

404

application/json

{"code": "string",
"type": "string",
"message": "string"
}

Retrieve specific VICAL

Retrieves a specific VICAL from the requested ecosystem by providing the VICAL version identifier.

Request

path Parameters

ecosystemId required	string <uuid> The UUID of the ecosystem Example: 87880d7e-a4d0-462e-8383-3f1e5e16865d
vicalIssueId required	integer <int32> Unique identifier of a specific VICAL version. This numeric value is continuously increased whenever a VICAL is created. Example: 1337

Responses

200

VICAL retrieved

404

Not Found. The specified resource was not found.

get/v1/ecosystems/{ecosystemId}/vicals/public/{vicalIssueId}

Request samples

Response samples

404

application/json

{"code": "string",
"type": "string",
"message": "string"
}