Izstrādātājiem

GET/v3/documents

Iegūt reģistrācijas profilu sarakstu

Atrodiet konta aktīvos lokālos profilus, izmantojot ierobežoto mantotās sistēmas lauku atlasi.

Šajā lapā
  1. Atrast esošos reģistrācijas profilus
  2. Saraksta pieprasījums
  3. Atbildes saraksts
  4. Atgrieztie profila lauki
  5. Turpmākās darbības

Atrast esošos reģistrācijas profilus

Iegūstiet ar savu API kontu saistīto aktīvo, nedzēsto lokālo reģistrācijas profilu sarakstu. Izmantojiet šo sarakstu, lai atrastu profila UUID pirms profila atvēršanas ar get_document, nevis lai noteiktu, vai tā apliecinošie dokumenti vai numura reģistrācija ir apstiprināti.

Saraksta pieprasījums

Autentificējieties, izmantojot savu iespējoto MultiTEL API kontu un tam atļauto IP adresi. Piemēros tiek izmantoti vides mainīgajos saglabāti HTTP Basic akreditācijas dati. Pārbaudiet gan HTTP atbildi, gan JSON lauku status.code; HTTP 200 atbilde pati par sevi neapliecina veiksmīgu izpildi. Visas piemēros izmantotās vērtības ir izdomātas.

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

Šajā apstrādātājā nav ieviests pieprasījuma pamatteksts, dalīšana lapās vai filtrēšanas parametri. Tas atgriež atbilstošā konta saglabātos profilus; nepaļaujieties uz noteiktu secību. Lieliem kontiem izvairieties no biežas visa saraksta atkārtotas pieprasīšanas.

Atbildes saraksts

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

Ja nav atbilstošu aktīvu profilu, apstrādātājs atgriež API kodu 200 un tukšu atbildes sarakstu. response[].id ir lokālā profila UUID, kas izveides laikā tiek atgriezts kā uuid; tas nav identitātes ID vai adreses ID.

Atgrieztie profila lauki

Lauku atlasē ir iekļauti 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 un date_created.

Neobligātās vērtības atkarībā no saglabātajiem datiem var būt tukšas vai null. Šajā mantotās sistēmas lauku atlasē nav iekļauti email, valstu izvēles lauki, identity_id, address_id, atsauces uz augšupielādētajiem failiem, apliecinošo dokumentu saraksti un verifikācijas statuss. Šis galapunkts nav paredzēts apliecinošo dokumentu statusa vai reģistrācijas apstiprinājuma noskaidrošanai. Uzskatiet atgrieztos identitātes, kontaktinformācijas un paraksta datus par privātiem.

Turpmākās darbības

Saglabājiet entītiju ID no sākotnējās create_document atbildes, lai vēlāk varētu veikt piesaistes. Ja šī atbilde ir pazaudēta, ar šo sarakstu šos ID nevar atgūt. Apskatiet profilu portālā vai sazinieties ar atbalsta dienestu, nevis automātiski izveidojiet dublikātu.