Fejlesztők

GET/v3/get_proof_types

Igazoláskategóriák listázása

Az igazoláskategóriák azonosítóinak és az entitástípusoknak a lekérdezése a személyazonosságot vagy lakcímet igazoló dokumentumok előkészítése előtt.

Ezen az oldalon
  1. Válasszon igazoláskategóriát
  2. Vegye figyelembe a tényleges követelményeket
  3. Kérés
  4. Válasz
  5. Hibák
  6. Elérhetőség és mellékhatások

Válasszon igazoláskategóriát

Az identitáshoz szükséges igazoló dokumentumok előkészítésekor használja a válaszban kapott kategóriát és entitástípust. Ez a lista kategóriákat ismertet, nem a feltöltött fájljait, és nem jelenti egyetlen igazolás jóváhagyását sem.

Vegye figyelembe a tényleges követelményeket

Egy kategória szereplése a listában nem jelenti azt, hogy az minden ország, számtípus vagy ügyfélidentitás követelményeinek megfelel. Az igazoló dokumentumok feltöltése előtt olvassa el az alkalmazandó követelményeket, és a válaszban kapott azonosítókat kezelje belső jelentés nélküli értékekként.

Kérés

Használja az engedélyezett API-fiókja hitelesítő adatait HTTPS-kapcsolaton keresztül. Az alapszintű hitelesítés és az engedélyezett API-fiókok bearer tokenjei támogatottak; a fiókra vonatkozó korlátozások érvényesek.

GET kérés az URL elérési útjában megadott, dokumentált paraméterekkel.

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

Válasz

A HTTP-állapot mellett ellenőrizze a JSON-törzsben található status.code értékét is. A response olyan objektumok tömbje, amelyek az id, name és entity_type mezőket tartalmazzák. Ezek az értékek az aktuális igazoláskatalógusból származnak. Az azonosítóknak nincs értelmezendő belső jelentésük; másolja át őket, ne állítson elő vagy képezzen hash-eléssel azonosítót. Üres katalógus is visszaadható sikeres válaszként. E példa alapján ne rögzítsen a kódban teljes entitástípus-felsorolást.

Szemléltető válaszszerkezet; nem valós idejű fiókadat és nem aktuális árajánlat.

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

Hibák

  • A hitelesítési vagy szolgáltatási hibák felismeréséhez ellenőrizze a status.code és a status.msg értékét. A sikeresen visszaadott üres katalógus nem jelenti egy dokumentum jóváhagyását vagy a regisztráció alóli mentességet.

Elérhetőség és mellékhatások

  • Ez a katalógus- és követelménylekérdezés nem hoz létre identitást, nem tölt fel igazolást, nem regisztrál számot és nem ad le megrendelést.
  • A sikeres katalógusválasz nem jelenti dokumentumai jóváhagyását, és nem erősíti meg, hogy a kiválasztott szám aktiválható.