Issuer: kom i gang

Første steg i Symfoni

1. Logg inn og opprett eller oppdater en credential template.
2. Noter templateSlug, som blir den stabile identifikatoren i API-et.
3. Opprett en issuer-API-nøkkel i Symfoni og lagre den sikkert. Nøkkelen vises bare en gang.

Base-URL og opprettelse av offer

Gatewayen ligger under:

https://www.symfoni.dev/api/issuers/<issuerSlug>

Opprett et offer med:

POST /api/issuers/{issuerSlug}/credentials/{templateSlug}/issue
Authorization: Bearer <symfoniApiKey>
Content-Type: application/json

Eksempel:

curl -X POST "https://www.symfoni.dev/api/issuers/brreg/credentials/euwoid/issue?offerUrlFormat=symfoni" 
  -H "Authorization: Bearer $SYMFONI_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "attributes": {
      "organizationnumber": "999888777",
      "legalname": "Brønnøysundregistrene"
    }
  }'

Forventet svar

{
  "issuanceId": "9357a8ce-f1c5-4d2d-b0d9-f20dd80fd770",
  "offerUri": "https://www.symfoni.dev/app/credential/offer?credential_offer_uri=...",
  "status": "offered",
  "templateSlug": "euwoid",
  "offerUrlFormat": "symfoni"
}

Lagre issuanceId. Det er denne du trenger for statuspolling og eventuell revokasjon.

Status og revokasjon

Hent status med:

GET /api/issuers/{issuerSlug}/issuances/{issuanceId}
Authorization: Bearer <symfoniApiKey>

Hvis du må tilbakekalle utstedelsen:

POST /api/issuers/{issuerSlug}/issuances/{issuanceId}/revoke
Authorization: Bearer <symfoniApiKey>

Feilbilder du bør forvente

• 401 ved manglende eller ugyldig bearer token.
• 404 hvis templateSlug eller issuanceId ikke finnes for denne issueren.
• 400 ved ugyldig payload, feil attributt-navn eller feil datatype.