Listoni profilet e regjistrimit

Gjeni profilet ekzistuese të regjistrimit

Listoni profilet lokale aktive dhe të pafshira të regjistrimit që lidhen me llogarinë tuaj API. Përdoreni këtë për të gjetur UUID-në e një profili përpara se ta hapni me get_document, jo për të përcaktuar nëse dokumentet e tij dëshmuese ose regjistrimi i numrit janë miratuar.

Kërkesa për listim

Autentikohuni me llogarinë tuaj të aktivizuar të API-së MultiTEL dhe adresën IP të lejuar për të. Shembujt përdorin kredenciale HTTP Basic të ruajtura në variablat e mjedisit. Kontrolloni si përgjigjen HTTP, ashtu edhe fushën JSON status.code; vetëm një përgjigje HTTP 200 nuk vërteton suksesin. Të gjitha vlerat në shembuj janë të sajuara.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/documents

Ky trajtues nuk zbaton trup kërkese, ndarje në faqe apo parametra filtrimi. Ai kthen profilet e ruajtura të llogarisë përkatëse; mos supozoni ndonjë renditje të caktuar. Për llogaritë e mëdha, shmangni kërkesat e shpeshta periodike për të gjithë listën.

Lista në përgjigje

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": [
    {
      "id": "11111111111111111111111111111111",
      "first_name": "Example",
      "last_name": "Person",
      "phone_number": "12025550123",
      "id_number": "",
      "birth_date": null,
      "company_name": "",
      "company_reg_number": "",
      "vat_id": "",
      "personal_tax_id": "",
      "description": "Example profile",
      "identity_type": "Personal",
      "postal_code": "00000",
      "city": "Example City",
      "address": "1 Example Street",
      "signature": "BASE64_PNG_SIGNATURE_DATA",
      "date_created": "2026-10-23 16:00:00"
    }
  ]
}

Kur nuk ka profile aktive që përputhen, trajtuesi kthen kodin API 200 dhe një listë të zbrazët në përgjigje. response[].id është UUID-ja e profilit lokal, e kthyer si uuid gjatë krijimit; nuk është ID identiteti apo ID adrese.

Fushat e profilit që kthehen

Përzgjedhja e fushave përmban id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature dhe date_created.

Vlerat opsionale mund të jenë të zbrazëta ose null, sipas të dhënave të ruajtura. Kjo përzgjedhje fushash e sistemit të vjetër nuk përfshin email, përzgjedhësit e shtetit, identity_id, address_id, referencat e skedarëve të ngarkuar, listat e dokumenteve dëshmuese dhe statusin e verifikimit. Kjo nuk është një pikë fundore për statusin e dokumenteve dëshmuese apo miratimin e regjistrimit. Trajtojini si private të dhënat e kthyera të identitetit, kontaktit dhe nënshkrimit.

Hapat e mëtejshëm

Ruani ID-të e entiteteve nga përgjigjja fillestare e create_document për bashkëngjitjet e mëvonshme. Nëse ajo përgjigje ka humbur, kjo listë nuk mund t'i rikuperojë ato ID. Shqyrtoni profilin në portal ose kontaktoni shërbimin e mbështetjes në vend që të krijoni automatikisht një dublikatë.