Integration Lab

Documentation · API

API · Certificates

Retrieval, signed download URLs and the approval gate.

Needs Verification
Purpose
Deliver credentials to the holder's existing portal.
Prerequisites
  • An approved attempt
Architecture
Approval → issuance → certificate.available event → retrieval with a signed URL.

Configuration

Download URLSigned and short-lived; do not cache in a public CDN

Implementation steps

  1. 01Subscribe to certificate.available
  2. 02Fetch metadata by certificate id
  3. 03Proxy the download through your own authorization check

Examples

Retrieve

bash
GET /api/v1/certificates/cert_01H8ZQA1F9

Testing procedure

  • Request before approval and assert 409 approval_pending

Troubleshooting

Expired download URL

Re-fetch metadata rather than storing the URL.