Vælg en dokumentationskategori
Brug den returnerede kategori og enhedstype, når du forbereder den dokumentation, der kræves for en identitet. Denne liste beskriver kategorier, ikke dine uploadede filer, og den udgør ikke en godkendelse af nogen dokumentation.
Følg de gældende krav
At en kategori er med på listen, betyder ikke, at den opfylder kravene for alle lande, nummertyper eller kundeidentiteter. Læs de gældende krav, før du uploader dokumentation, og behandl returnerede ID'er som uigennemsigtige værdier.
Forespørgsel
Brug legitimationsoplysningerne til din aktiverede API-konto via HTTPS. Grundlæggende godkendelse og aktiverede bearer-tokens til API-konti understøttes; kontobegrænsninger gælder.
GET med eventuelle dokumenterede parametre i URL-stien.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_proof_types"Svar
Kontrollér status.code i JSON-indholdet samt HTTP-statussen. response er et array af objekter med id, name og entity_type. Disse værdier kommer fra det aktuelle dokumentationskatalog. ID'er er uigennemsigtige værdier; kopiér dem i stedet for at konstruere et ID eller danne et ved hjælp af hashing. Et tomt katalog kan returneres uden fejl. Hardkod ikke en fuldstændig opregning af enhedstyper ud fra dette eksempel.
Eksempel på svarstruktur; hverken aktuelle kontodata eller et aktuelt pristilbud.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"id": "PROOF_TYPE_ID_FROM_RESPONSE",
"name": "Example proof category",
"entity_type": "ENTITY_TYPE_FROM_RESPONSE"
}
]
}Fejl
- Kontrollér status.code og status.msg for godkendelses- eller tjenestefejl. Et tomt katalog, der returneres uden fejl, er hverken en godkendelse af et dokument eller en fritagelse for registrering.
Tilgængelighed og sideeffekter
- Dette opslag i kataloget eller kravene opretter ikke en identitet, uploader ikke dokumentation, registrerer ikke et nummer og afgiver ikke en ordre.
- Et katalogsvar uden fejl er hverken en godkendelse af dine dokumenter eller en bekræftelse på, at et valgt nummer kan aktiveres.