Patvirtinamųjų dokumentų kategorijų sąrašas

Pasirinkite patvirtinamojo dokumento kategoriją

Ruošdami tapatybei reikalingus patvirtinamuosius dokumentus, naudokite grąžintą kategoriją ir subjekto tipą. Šiame sąraše aprašomos kategorijos, o ne jūsų įkelti failai; jis taip pat nereiškia, kad kuris nors patvirtinamasis dokumentas yra patvirtintas.

Vadovaukitės taikomais reikalavimais

Tai, kad kategorija įtraukta į sąrašą, nereiškia, jog ji atitinka visų šalių, numerių tipų ar klientų tapatybių reikalavimus. Prieš įkeldami patvirtinamuosius dokumentus, perskaitykite taikomus reikalavimus ir neinterpretuokite grąžintų identifikatorių vidinės struktūros.

Užklausa

Naudokite įgalintos API paskyros prisijungimo duomenis per HTTPS. Palaikomas bazinis autentifikavimas ir įgalinti API paskyros prieigos žetonai, suteikiantys prieigą jų turėtojui; taikomi paskyros apribojimai.

GET su bet kuriuo dokumentacijoje nurodytu parametru URL kelyje.

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

Atsakymas

Patikrinkite ir status.code JSON turinyje, ir HTTP būseną. response yra objektų su id, name ir entity_type laukais masyvas. Šios reikšmės gaunamos iš dabartinio patvirtinamųjų dokumentų katalogo. Identifikatorių vidinė struktūra neinterpretuojama; nukopijuokite juos, užuot patys juos sudarę ar generavę maišos funkcija. Tuščias katalogas gali būti grąžintas sėkmingai. Remdamiesi šiuo pavyzdžiu, neįrašykite į kodą fiksuoto visų galimų subjektų tipų sąrašo.

Pavyzdinė atsakymo struktūra; tai nėra tiesioginiai paskyros duomenys ar dabartinis kainos pasiūlymas.

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

Klaidos

• Patikrinkite status.code ir status.msg, ar nėra autentifikavimo arba paslaugos klaidų. Sėkmingai grąžintas tuščias katalogas nereiškia, kad dokumentas patvirtintas ar kad registracija neprivaloma.

Prieinamumas ir šalutinis poveikis

• Ši katalogo ir reikalavimų paieška nesukuria tapatybės įrašo, neįkelia patvirtinamojo dokumento, neregistruoja numerio ir nepateikia užsakymo.
• Sėkmingas katalogo atsakymas nereiškia, kad jūsų dokumentai patvirtinti ar kad pasirinktą numerį galima aktyvinti.