Разработчици

GET/v3/get_document/{uuid}

Прочитане на регистрационен профил

Прочетете един активен профил, принадлежащ на акаунта, чрез UUID на неговия локален документ.

На тази страница
  1. Прочитане на един съхранен профил
  2. Заявка за профил
  3. Отговор с профила
  4. Върнати полета на профила
  5. Не е намерено и повторни опити

Прочитане на един съхранен профил

Извлечете активния локален регистрационен профил, избран чрез неговия UUID в рамките на вашия акаунт. Връщат се същите ограничени полета на профила като при documents; това не обновява проверката от оператора и не връща прикачените удостоверителни документи.

Заявка за профил

Удостоверете се с вашия активиран акаунт за MultiTEL API и разрешения за него IP адрес. Примерите използват идентификационни данни за HTTP Basic удостоверяване, съхранени в променливи на средата. Проверете както HTTP отговора, така и JSON полето status.code; сам по себе си HTTP 200 отговорът не потвърждава успех. Всички стойности в примерите са измислени.

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

Задайте на DOCUMENT_UUID стойността на response.uuid от create_document, или на response[].id от documents. Тук не използвайте identity_id, address_id, идентификатор на удостоверителен документ или телефонен номер. Не е необходимо тяло на заявката.

Отговор с профила

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

Върнати полета на профила

Този набор от полета съдържа 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 и date_created.

Незадължителните стойности може да са празни или null според съхранените данни. Този набор от полета от по-стара версия пропуска email, полетата за избор на държава, identity_id, address_id, препратките към качени файлове, списъците с удостоверителни документи и статуса на проверката. Тази крайна точка не служи за проверка на статуса на удостоверителните документи или за одобряване на регистрация. Третирайте върнатите данни за самоличност, контакт и подпис като поверителни.

Не е намерено и повторни опити

API код 404 със съобщение Failed, Not found означава, че не е намерен съответстващ активен профил за този акаунт и UUID. Проверете акаунта, идентификатора и дали профилът е изтрит. Това търсене не разкрива профил от друг акаунт.

Успешното прочитане не потвърждава приемането на удостоверителните документи или активирането на номера. Ако продължавате след заявка за създаване или прикачване с неясен резултат, прегледайте документа в портала, преди да изпратите друга заявка, която променя състоянието.