Valitse todistusluokka
Käytä palautettua luokkaa ja entiteettityyppiä, kun valmistelet identiteettiä varten vaadittavaa todistusaineistoa. Luettelo kuvaa luokkia, ei lataamiasi tiedostoja, eikä se tarkoita minkään todistuksen hyväksymistä.
Noudata todellisia vaatimuksia
Luokan esiintyminen luettelossa ei tarkoita, että se täyttää kaikkien maiden, numerotyyppien tai asiakasidentiteettien vaatimukset. Lue sovellettavat vaatimukset ennen todistusaineiston lataamista ja käsittele palautettuja tunnisteita läpinäkymättöminä arvoina tulkitsematta niiden sisältöä.
Pyyntö
Käytä käytössä olevan API-tilisi tunnuksia HTTPS-yhteyden kautta. Tuettuja ovat perustodennus ja käyttöön otetut API-tilin bearer-tunnukset; tilin rajoitukset ovat voimassa.
GET siten, että mahdollinen dokumentoitu parametri on URL-polussa.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_proof_types"Vastaus
Tarkista JSON-vastausrungon status.code sekä HTTP-tilakoodi. response on taulukko olioita, jotka sisältävät kentät id, name ja entity_type. Nämä arvot ovat peräisin nykyisestä todistusluettelosta. Tunnisteet ovat läpinäkymättömiä arvoja; kopioi ne sen sijaan, että muodostaisit tunnisteen itse tai loisit sen tiivistefunktion avulla. Tyhjä luettelo voidaan palauttaa onnistuneessa vastauksessa. Älä kovakoodaa tämän esimerkin perusteella täydellistä entiteettityyppien luettelotyyppiä.
Havainnollistava vastauksen rakenne; ei reaaliaikaisia tilitietoja eikä ajantasaista hintatarjousta.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"id": "PROOF_TYPE_ID_FROM_RESPONSE",
"name": "Example proof category",
"entity_type": "ENTITY_TYPE_FROM_RESPONSE"
}
]
}Virheet
- Tarkista todennus- tai palveluvirheet kentistä status.code ja status.msg. Tyhjän luettelon palautuminen onnistuneesti ei tarkoita asiakirjan hyväksymistä eikä vapautusta rekisteröintivaatimuksesta.
Saatavuus ja sivuvaikutukset
- Tämä luettelotietojen tai vaatimusten haku ei luo identiteettiä, lataa todistusta palveluun, rekisteröi numeroa eikä tee tilausta.
- Onnistunut luettelovastaus ei tarkoita asiakirjojesi hyväksymistä eikä vahvistusta siitä, että valittu numero voidaan aktivoida.