Listează categoriile de documente justificative

Alegeți o categorie de documente justificative

Folosiți categoria și tipul de entitate returnate atunci când pregătiți dovezile necesare pentru o identitate. Această listă descrie categorii, nu fișierele pe care le-ați încărcat, și nu reprezintă aprobarea vreunui document justificativ.

Respectați cerințele aplicabile

Faptul că o categorie apare în listă nu înseamnă că aceasta îndeplinește cerințele pentru orice țară, tip de număr sau identitate de client. Citiți cerințele aplicabile înainte de a încărca dovezi și tratați identificatorii returnați ca valori opace.

Cerere

Folosiți prin HTTPS datele de autentificare ale contului API activat. Sunt acceptate autentificarea de bază și tokenurile de tip bearer activate pentru contul API; se aplică restricțiile contului.

GET cu orice parametru documentat în calea URL-ului.

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

Răspuns

Verificați status.code în corpul JSON, precum și codul de stare HTTP. response este un tablou de obiecte cu câmpurile id, name și entity_type. Aceste valori provin din catalogul actual de documente justificative. Identificatorii sunt opaci; copiați-i în loc să construiți unul sau să îl generați printr-o funcție hash. Un catalog gol poate fi returnat cu succes. Nu definiți direct în cod o enumerare completă a tipurilor de entități pe baza acestui exemplu.

Structură de răspuns cu titlu ilustrativ; nu reprezintă date în timp real din cont sau o ofertă de preț actuală.

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

Erori

• Verificați status.code și status.msg pentru erori de autentificare sau de serviciu. Returnarea cu succes a unui catalog gol nu reprezintă aprobarea unui document sau o scutire de la înregistrare.

Disponibilitate și efecte secundare

• Această consultare a catalogului sau a cerințelor nu creează o identitate, nu încarcă un document justificativ, nu înregistrează un număr și nu plasează o comandă.
• Un răspuns reușit la consultarea catalogului nu reprezintă aprobarea documentelor dumneavoastră sau confirmarea faptului că un număr selectat poate fi activat.