Programeri

GET/v3/documents

Popis registracijskih profila

Pronađite aktivne lokalne profile računa koristeći ograničeni skup polja starijeg sustava.

Na ovoj stranici
  1. Pronađite postojeće registracijske profile
  2. Zahtjev za dohvat popisa
  3. Popis u odgovoru
  4. Vraćena polja profila
  5. Sljedeći koraci

Pronađite postojeće registracijske profile

Dohvatite popis aktivnih lokalnih registracijskih profila povezanih s vašim API računom koji nisu izbrisani. Upotrijebite ga za pronalaženje UUID-a profila prije nego što profil otvorite pozivom get_document, a ne za utvrđivanje jesu li njegovi dokazni dokumenti ili registracija broja odobreni.

Zahtjev za dohvat popisa

Autentificirajte se svojim omogućenim MultiTEL API računom i njegovom dopuštenom IP adresom. Primjeri koriste vjerodajnice za HTTP Basic pohranjene u varijablama okruženja. Provjerite i HTTP odgovor i polje u JSON-u status.code; sam HTTP odgovor 200 ne potvrđuje uspjeh. Sve vrijednosti u primjerima su izmišljene.

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

Ovaj obrađivač ne podržava tijelo zahtjeva, straničenje ni parametre filtriranja. Vraća pohranjene profile odgovarajućeg računa; nemojte pretpostavljati određeni redoslijed. Za velike račune izbjegavajte često ponavljano dohvaćanje cijelog popisa.

Popis u odgovoru

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

Ako nema odgovarajućih aktivnih profila, obrađivač vraća API kod 200 i prazan popis u odgovoru. response[].id je UUID lokalnog profila vraćen kao uuid pri stvaranju; nije ID identiteta ni ID adrese.

Vraćena polja profila

Skup vraćenih polja sadrži 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 i date_created.

Neobavezne vrijednosti mogu biti prazne ili null, ovisno o pohranjenim podacima. Ovaj skup polja starijeg sustava izostavlja email, polja za odabir države, identity_id, address_id, reference na prenesene datoteke, popise dokaznih dokumenata i status provjere. Ovo nije krajnja točka za status dokaznih dokumenata ili odobrenje registracije. S vraćenim podacima o identitetu, kontaktu i potpisu postupajte kao s privatnim podacima.

Sljedeći koraci

Spremite ID-ove entiteta iz izvornog odgovora poziva create_document za kasnija pridruživanja. Ako je taj odgovor izgubljen, ovaj popis ne može vratiti te ID-ove. Pregledajte profil na portalu ili se obratite podršci umjesto da automatski stvorite duplikat.