Registreerimisprofiilide loetelu

Olemasolevate registreerimisprofiilide leidmine

Loetlege oma API kontoga seotud aktiivsed kohalikud registreerimisprofiilid, mida ei ole kustutatud. Kasutage seda profiili UUID leidmiseks enne profiili avamist päringuga get_document, mitte selleks, et teha kindlaks, kas selle tõendid või numbri registreerimine on heaks kiidetud.

Loendi päring

Autentige oma lubatud MultiTEL API kontoga, kasutades sellele lubatud IP-aadressi. Näidetes kasutatakse keskkonnamuutujatesse salvestatud HTTP Basic 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/documents

See päringutöötleja ei toeta päringu keha, lehekülgedeks jaotamist ega filtreerimisparameetreid. See tagastab vastava konto salvestatud profiilid; ärge eeldage kindlat järjestust. Suurte kontode puhul vältige kogu loendi sagedast korduvat pärimist.

Vastuse loend

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

Kui vastavaid aktiivseid profiile ei ole, tagastab päringutöötleja API koodi 200 ja tühja vastuseloendi. response[].id on kohaliku profiili UUID, mis tagastatakse loomisel väljal uuid; see ei ole identiteedi ID ega aadressi ID.

Tagastatavad profiiliväljad

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 olenevalt salvestatud andmetest olla tühjad või null. See pärandlahenduse väljade valik ei sisalda välja email, riigivalikuid, välju identity_id ja address_id, üleslaaditud failide viiteid, tõendite loendeid ega kontrollimise olekut. See ei ole tõendite oleku ega registreerimise heakskiidu pärimiseks mõeldud lõpp-punkt. Käsitlege tagastatud identiteedi-, kontakt- ja allkirjaandmeid privaatsetena.

Järgmised sammud

Salvestage olemite ID-d algse päringu create_document vastusest, et neid hiljem sidumiseks kasutada. Kui see vastus on kadunud, ei saa neid selle loendi abil taastada. Vaadake profiili portaalis või võtke ühendust kasutajatoega, selle asemel et automaatselt duplikaat luua.