Kūrėjams

GET/v3/get_document/{uuid}

Gauti registracijos profilį

Gauti vieną aktyvų paskyrai priklausantį profilį pagal jo vietinio dokumento UUID.

Šiame puslapyje
  1. Gauti vieną išsaugotą profilį
  2. Profilio užklausa
  3. Profilio atsakymas
  4. Grąžinami profilio laukai
  5. Nerastas profilis ir pakartotinės užklausos

Gauti vieną išsaugotą profilį

Gaukite savo paskyros aktyvų vietinį registracijos profilį, pasirinktą pagal jo UUID. Grąžinamas toks pat ribotas profilio laukų rinkinys kaip ir naudojant documents; operatoriaus patikros duomenys neatnaujinami, o pridėti patvirtinamieji dokumentai negrąžinami.

Profilio užklausa

Autentifikuokitės naudodami savo įjungtą MultiTEL API paskyrą ir jai leidžiamą IP adresą. Pavyzdžiuose naudojami aplinkos kintamuosiuose saugomi HTTP Basic autentifikavimo duomenys. Patikrinkite ir HTTP atsakymą, ir JSON lauką status.code; vien HTTP 200 atsakymas nepatvirtina, kad užklausa sėkminga. Visos pavyzdžių reikšmės yra išgalvotos.

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

Kintamajam DOCUMENT_UUID priskirkite response.uuid reikšmę iš create_document, arba response[].id reikšmę iš documents. Čia nenaudokite identity_id, address_id, patvirtinamojo dokumento ID ar telefono numerio. Užklausos turinio nereikia.

Profilio atsakymas

{
  "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"
  }
}

Grąžinami profilio laukai

Į grąžinamų laukų rinkinį įeina 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 ir date_created.

Atsižvelgiant į išsaugotus duomenis, neprivalomos reikšmės gali būti tuščios arba null. Į šį senąjį grąžinamų laukų rinkinį neįtraukiami email, šalies parinkimo laukai, identity_id, address_id, nuorodos į įkeltus failus, patvirtinamųjų dokumentų sąrašai ir patikros būsena. Šis API galinis taškas nėra skirtas patvirtinamųjų dokumentų būsenai ar registracijos patvirtinimui nustatyti. Grąžinamus tapatybės, kontaktinius ir parašo duomenis laikykite privačiais.

Nerastas profilis ir pakartotinės užklausos

API kodas 404 su pranešimu Failed, Not found reiškia, kad šiai paskyrai ir UUID nerastas joks atitinkamas aktyvus profilis. Patikrinkite paskyrą, identifikatorių ir tai, ar profilis nebuvo ištrintas. Ši paieška neatskleidžia kitai paskyrai priklausančio profilio.

Sėkmingas profilio gavimas nepatvirtina, kad patvirtinamieji dokumentai priimti ar numeris aktyvuotas. Jei tęsiate darbą po kūrimo ar pridėjimo užklausos, kurios rezultatas neaiškus, prieš teikdami kitą būseną keičiančią užklausą patikrinkite dokumentą portale.