Registreerimisprofiili lugemine

Ühe salvestatud profiili lugemine

Hankige oma kontolt aktiivne kohalik registreerimisprofiil selle UUID alusel. Tagastatakse sama piiratud profiiliväljade kogum nagu päringuga documents; see ei värskenda operaatoripoolset kontrolli ega tagasta lisatud tõendusdokumente.

Profiili päring

Autentige oma lubatud MultiTEL API kontoga, kasutades sellele lubatud IP-aadressi. Näidetes kasutatakse keskkonnamuutujatesse salvestatud HTTP Basicu autentimisandmeid. Kontrollige nii HTTP-vastust kui ka JSON-välja status.code; üksnes HTTP 200 vastus ei kinnita õnnestumist. Kõik näidisväärtused on väljamõeldud.

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

Määrake DOCUMENT_UUID väärtuseks response.uuid, mille tagastab create_document, või response[].id, mille tagastab documents. Ärge kasutage siin väärtusi identity_id ega address_id, tõendusdokumendi ID-d ega telefoninumbrit. Päringu keha ei ole vaja.

Profiili vastus

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

Tagastatavad profiiliväljad

Tagastatavate väljade valik sisaldab välju 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 ja date_created.

Valikulised väärtused võivad salvestatud andmetest olenevalt olla tühjad või null. See pärandlahenduse väljade valik ei sisalda välja email, riigi valikuvälju, välju identity_id ja address_id, üleslaaditud failide viiteid, tõendusdokumentide loendeid ega kontrolli olekut. See ei ole tõendusdokumentide oleku ega registreerimise heakskiidu pärimise lõpp-punkt. Käsitlege tagastatud isiku-, kontakt- ja allkirjaandmeid privaatsetena.

Profiili puudumine ja korduskatsed

API kood 404 koos teatega Failed, Not found tähendab, et selle konto ja UUID jaoks ei leitud vastavat aktiivset profiili. Kontrollige kontot, identifikaatorit ja seda, kas profiil on kustutatud. See päring ei avalda teise konto profiili.

Edukas lugemine ei kinnita tõendusdokumentide vastuvõtmist ega numbri aktiveerimist. Kui selgitate olukorda pärast ebaselge tulemusega loomise või lisamise päringut, vaadake enne järgmise olekut muutva päringu tegemist portaalis dokument üle.