Fejlesztők

GET/v3/get_document/{uuid}

Regisztrációs profil lekérése

A fiókhoz tartozó aktív profil lekérése a helyi dokumentum UUID-je alapján.

Ezen az oldalon
  1. Egy tárolt profil lekérése
  2. Profil lekérésére irányuló kérés
  3. A profillekérés válasza
  4. Visszaadott profilmezők
  5. Nem található profil és újrapróbálkozások

Egy tárolt profil lekérése

Kérje le a fiókján belüli aktív helyi regisztrációs profilt az UUID-je alapján. Ez ugyanazokat a korlátozott profilmezőket adja vissza, mint a documents; nem frissíti a szolgáltatói ellenőrzést, és nem adja vissza a csatolt igazoló dokumentumokat.

Profil lekérésére irányuló kérés

Végezze el a hitelesítést az engedélyezett MultiTEL API-fiókjával, az ahhoz engedélyezett IP-címről. A példák környezeti változókban tárolt HTTP Basic hitelesítő 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 igazolja a sikert. A példákban szereplő összes érték kitalált.

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

A DOCUMENT_UUID értékét állítsa a response.uuid mező értékére a következő művelet válaszából: create_document, vagy használja a response[].id mező értékét a documents válaszából. Itt ne használjon identity_id vagy address_id értéket, igazoló dokumentum azonosítóját vagy telefonszámot. Nincs szükség kéréstörzsre.

A profillekérés válasza

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

Visszaadott profilmezők

A visszaadott mezőkészlet a következőket tartalmazza: 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.

Az opcionális é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 az email mezőt, az országválasztókat, az identity_id és address_id mezőt, a feltöltött fájlokra mutató hivatkozásokat, az igazoló dokumentumok listáit és az ellenőrzés állapotát. Ez nem az igazoló dokumentumok állapotának vagy a regisztráció jóváhagyásának lekérdezésére szolgáló végpont. A visszaadott személyazonossági, kapcsolattartási és aláírási adatokat kezelje bizalmasan.

Nem található profil és újrapróbálkozások

A 404 API-kód a következő üzenettel: Failed, Not found azt jelenti, hogy ehhez a fiókhoz és UUID-hez nem található megfelelő aktív profil. Ellenőrizze a fiókot, az azonosítót és azt, hogy törölték-e a profilt. Ez a lekérdezés nem fedi fel más fiók profilját.

A sikeres lekérés nem igazolja az igazoló dokumentumok elfogadását vagy a telefonszám aktiválását. Ha egy bizonytalan kimenetelű létrehozási vagy csatolási kérés után folytatja a műveletet, vizsgálja meg a dokumentumot a portálon, mielőtt újabb állapotmódosító kérést küldene.