Regisztrációs profilok listázása

Meglévő regisztrációs profilok keresése

Listázza az API-fiókjához tartozó aktív, nem törölt helyi regisztrációs profilokat. Ezzel megkeresheti egy profil UUID-ját, mielőtt megnyitná a következővel: get_document, és ne annak megállapítására használja, hogy jóváhagyták-e az igazoló dokumentumait vagy a telefonszám regisztrációját.

Listázási kérés

A hitelesítéshez használja az engedélyezett MultiTEL API-fiókját és az ahhoz engedélyezett IP-címet. A példák környezeti változókban tárolt HTTP Basic hitelesítési adatokat használnak. Ellenőrizze mind a HTTP-választ, mind a JSON következő mezőjét: status.code; a HTTP 200 válasz önmagában nem jelenti a művelet sikerességét. A példákban szereplő összes érték kitalált.

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

Ez a kéréskezelő nem támogat kéréstörzset, lapozást vagy szűrési paramétereket. A megfelelő fiók tárolt profiljait adja vissza; ne feltételezzen meghatározott sorrendet. Nagy fiókok esetén kerülje a teljes lista gyakori, ismétlődő lekérdezését.

Válaszlista

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

Ha nincs megfelelő aktív profil, a kéréskezelő 200 API-kódot és üres válaszlistát ad vissza. response[].id a helyi profil UUID-ja, amelyet a létrehozáskor a uuid mezőben kapott vissza; ez nem személyazonosság-azonosító és nem címazonosító.

Visszaadott profilmezők

A visszaadott mezők: 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 és date_created.

A nem kötelező értékek a tárolt adatoktól függően üresek vagy null értékűek lehetnek. Ez a régi mezőkészlet nem tartalmazza a következőket: email, országválasztó mezők, identity_id, address_id, a feltöltött fájlokra mutató hivatkozások, az igazoló dokumentumok listái és az ellenőrzés állapota. Ez a végpont nem az igazoló dokumentumok állapotának vagy a regisztráció jóváhagyásának lekérdezésére szolgál. A visszaadott személyazonossági, kapcsolattartási és aláírási adatokat kezelje bizalmasan.

Következő lépések

A későbbi csatolásokhoz mentse el az eredeti create_document válaszában szereplő entitásazonosítókat. Ha ez a válasz elveszett, ebből a listából nem állíthatók helyre. Tekintse meg a profilt a portálon vagy forduljon az ügyfélszolgálathoz ahelyett, hogy automatikusan létrehozna egy másodpéldányt.