Programiści

GET/v3/get_document/{uuid}

Pobieranie profilu rejestracyjnego

Pobierz jeden aktywny profil należący do konta na podstawie lokalnego identyfikatora UUID dokumentu.

Na tej stronie
  1. Pobieranie jednego zapisanego profilu
  2. Żądanie pobrania profilu
  3. Odpowiedź z profilem
  4. Zwracane pola profilu
  5. Brak wyniku i ponawianie żądań

Pobieranie jednego zapisanego profilu

Pobierz aktywny lokalny profil rejestracyjny wybrany na podstawie identyfikatora UUID w obrębie Twojego konta. Zwracany jest ten sam ograniczony zestaw pól profilu co w przypadku documents; operacja nie odświeża weryfikacji u operatora ani nie zwraca dołączonych dokumentów potwierdzających.

Żądanie pobrania profilu

Uwierzytelnij się przy użyciu aktywowanego konta API MultiTEL, korzystając z dozwolonego dla niego adresu IP. Przykłady wykorzystują dane uwierzytelniające HTTP Basic zapisane w zmiennych środowiskowych. Sprawdź zarówno odpowiedź HTTP, jak i następujące pole JSON: status.code; sama odpowiedź HTTP 200 nie potwierdza powodzenia operacji. Wszystkie przykładowe wartości są fikcyjne.

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

Ustaw DOCUMENT_UUID na wartość response.uuid z create_document, albo na wartość response[].id z documents. Nie używaj tutaj identity_id, address_id, identyfikatora dokumentu potwierdzającego ani numeru telefonu. Treść żądania nie jest wymagana.

Odpowiedź z profilem

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

Zwracane pola profilu

Zwracany zestaw pól obejmuje 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.

Wartości opcjonalne mogą być puste lub mieć wartość null, zależnie od zapisanych danych. Ten starszy zestaw zwracanych pól pomija email, pola wyboru kraju, identity_id, address_id, odwołania do przesłanych plików, listy dokumentów potwierdzających oraz status weryfikacji. Ten punkt końcowy nie służy do sprawdzania statusu dokumentów potwierdzających ani zatwierdzania rejestracji. Traktuj zwrócone dane dotyczące tożsamości, dane kontaktowe i dane podpisu jako prywatne.

Brak wyniku i ponawianie żądań

Kod API 404 z komunikatem Failed, Not found oznacza, że nie znaleziono pasującego aktywnego profilu dla tego konta i identyfikatora UUID. Sprawdź konto, identyfikator oraz to, czy profil został usunięty. To wyszukiwanie nie ujawnia profilu należącego do innego konta.

Pomyślne pobranie nie potwierdza zaakceptowania dokumentów potwierdzających ani aktywacji numeru. Jeśli kontynuujesz po żądaniu utworzenia lub dołączenia, którego wynik jest niepewny, sprawdź dokument w portalu przed wysłaniem kolejnego żądania zmieniającego stan.