Zhvilluesit

GET/v3/get_document/{uuid}

Leximi i një profili regjistrimi

Lexoni një profil aktiv që i përket llogarisë, përmes UUID-së së dokumentit të tij lokal.

Në këtë faqe
  1. Leximi i një profili të ruajtur
  2. Kërkesa për profilin
  3. Përgjigjja për profilin
  4. Fushat e profilit që kthehen
  5. Profili nuk u gjet dhe riprovimet

Leximi i një profili të ruajtur

Merrni profilin lokal aktiv të regjistrimit, të zgjedhur përmes UUID-së së tij brenda llogarisë suaj. Kjo kthen të njëjtat fusha të kufizuara të profilit si documents; nuk rifreskon verifikimin nga operatori i telekomunikacionit dhe nuk kthen dokumentet dëshmuese të bashkëngjitura.

Kërkesa për profilin

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ë variabla të mjedisit. Kontrolloni si përgjigjen HTTP, ashtu edhe fushën JSON status.code; vetëm një përgjigje HTTP 200 nuk konfirmon suksesin. Të gjitha vlerat në shembuj janë të sajuara.

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

Vendosni DOCUMENT_UUID në vlerën e response.uuid nga create_document, ose në vlerën e response[].id nga documents. Mos përdorni këtu identity_id, address_id, ID-në e një dokumenti dëshmues ose një numër telefoni. Nuk nevojitet trup kërkese.

Përgjigjja për profilin

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "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"
  }
}

Fushat e profilit që kthehen

Projeksioni 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ë bosh ose null, në varësi të të dhënave të ruajtura. Ky projeksion i trashëguar nuk përfshin email, fushat e përzgjedhjes së 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 ose për miratimin e regjistrimit. Trajtojini si private të dhënat e kthyera të identitetit, kontaktit dhe nënshkrimit.

Profili nuk u gjet dhe riprovimet

Kodi API 404 me mesazhin Failed, Not found do të thotë se nuk u gjet asnjë profil aktiv që përputhet me këtë llogari dhe UUID. Kontrolloni llogarinë, identifikuesin dhe nëse profili është fshirë. Ky kërkim nuk zbulon profilin e një llogarie tjetër.

Një lexim i suksesshëm nuk konfirmon pranimin e dokumenteve dëshmuese ose aktivizimin e numrit. Nëse po rifilloni veprimet pas një kërkese krijimi ose bashkëngjitjeje me rezultat të pasigurt, shqyrtoni dokumentin në portal përpara se të bëni një tjetër kërkesë që ndryshon gjendjen.