Listoni kategoritë e dokumenteve dëshmuese

Zgjidhni një kategori dokumentesh dëshmuese

Përdorni kategorinë dhe llojin e entitetit të kthyer kur përgatitni dëshmitë e kërkuara për një identitet. Kjo listë përshkruan kategori, jo skedarët që keni ngarkuar, dhe nuk përbën miratim të ndonjë dokumenti dëshmues.

Përmbushni kërkesat që zbatohen

Fakti që një kategori është në listë nuk do të thotë se ajo përmbush kërkesat për çdo shtet, lloj numri apo identitet klienti. Lexoni kërkesat që zbatohen përpara se të ngarkoni dëshmi dhe trajtojini identifikuesit e kthyer si vlera opake.

Kërkesa

Përdorni kredencialet e llogarisë suaj të aktivizuar API përmes HTTPS. Mbështeten autentikimi bazë dhe tokenët e tipit bearer të aktivizuar për llogarinë API; zbatohen kufizimet e llogarisë.

GET me çdo parametër të dokumentuar në shtegun e URL-së.

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

Përgjigjja

Kontrolloni status.code në trupin JSON, si dhe statusin HTTP. response është një varg objektesh me fushat id, name dhe entity_type. Këto vlera vijnë nga katalogu aktual i dokumenteve dëshmuese. Identifikuesit janë opakë; kopjojini në vend që të ndërtoni një të tillë ose ta gjeneroni me një funksion hash. Një katalog bosh mund të kthehet me sukses. Mos përcaktoni drejtpërdrejt në kod një numërim të plotë të llojeve të entiteteve duke u bazuar në këtë shembull.

Strukturë ilustruese e përgjigjes; nuk përfaqëson të dhëna të llogarisë në kohë reale apo një ofertë çmimi aktuale.

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

Gabimet

• Kontrolloni status.code dhe status.msg për gabime autentikimi ose të shërbimit. Kthimi me sukses i një katalogu bosh nuk përbën miratim të një dokumenti apo përjashtim nga regjistrimi.

Disponueshmëria dhe efektet anësore

• Ky kërkim në katalog ose në kërkesa nuk krijon një identitet, nuk ngarkon një dokument dëshmues, nuk regjistron një numër dhe nuk kryen një porosi.
• Një përgjigje e suksesshme nga katalogu nuk përbën miratim të dokumenteve tuaja apo konfirmim se një numër i zgjedhur mund të aktivizohet.