Lista intygskategorier

Välj en intygskategori

Använd den returnerade kategorin och entitetstypen när du förbereder det underlag som krävs för en identitet. Listan beskriver kategorier, inte dina uppladdade filer, och innebär inte att något intyg har godkänts.

Utgå från de faktiska kraven

Att en kategori finns med i listan betyder inte att den uppfyller kraven för alla länder, nummertyper eller kundidentiteter. Läs de tillämpliga kraven innan du laddar upp underlag och behandla returnerade ID:n som opaka värden utan att tolka deras innehåll.

Begäran

Använd inloggningsuppgifterna för ditt aktiverade API-konto via HTTPS. Grundläggande autentisering och aktiverade bearer-token för API-konton stöds; kontots begränsningar gäller.

GET med eventuell dokumenterad parameter i URL-sökvägen.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_proof_types"

Svar

Kontrollera status.code i JSON-svarskroppen samt HTTP-statusen. response är en array av objekt med id, name och entity_type. Dessa värden kommer från den aktuella intygskatalogen. ID:n är opaka värden; kopiera dem i stället för att konstruera ett eget eller skapa ett med en hashfunktion. En tom katalog kan returneras i ett lyckat svar. Hårdkoda inte en fullständig uppräkning av entitetstyper utifrån det här exemplet.

Illustration av svarets struktur; inga aktuella kontouppgifter eller någon aktuell prisoffert.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "PROOF_TYPE_ID_FROM_RESPONSE",
      "name": "Example proof category",
      "entity_type": "ENTITY_TYPE_FROM_RESPONSE"
    }
  ]
}

Fel

• Kontrollera status.code och status.msg för autentiseringsfel eller tjänstefel. Att en tom katalog returneras i ett lyckat svar innebär inte att ett dokument har godkänts eller att undantag från registreringskravet har beviljats.

Tillgänglighet och sidoeffekter

• Den här sökningen efter kataloguppgifter eller krav skapar ingen identitet, laddar inte upp något intyg, registrerar inget nummer och lägger ingen beställning.
• Ett lyckat katalogsvar innebär inte att dina dokument har godkänts eller att det har bekräftats att ett valt nummer kan aktiveras.