Wyświetl kategorie dokumentów potwierdzających

Wybierz kategorię dokumentu potwierdzającego

Użyj zwróconej kategorii i typu podmiotu podczas przygotowywania dokumentów wymaganych dla danej tożsamości. Ta lista opisuje kategorie, a nie przesłane przez Ciebie pliki, i nie oznacza zatwierdzenia żadnego dokumentu potwierdzającego.

Spełnij rzeczywiście obowiązujące wymagania

Obecność kategorii na liście nie oznacza, że spełnia ona wymagania dla każdego kraju, typu numeru lub tożsamości klienta. Przed przesłaniem dokumentów zapoznaj się z obowiązującymi wymaganiami i traktuj zwrócone identyfikatory jako nieprzezroczyste wartości, bez wywodzenia znaczenia z ich budowy.

Żądanie

Użyj danych uwierzytelniających aktywowanego konta API przez HTTPS. Obsługiwane są uwierzytelnianie podstawowe HTTP oraz aktywowane tokeny typu bearer dla kont API; obowiązują ograniczenia konta.

GET z ewentualnymi udokumentowanymi parametrami w ścieżce URL.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_proof_types"

Odpowiedź

Sprawdź zarówno status.code w treści JSON, jak i status HTTP. response to tablica obiektów z polami id, name i entity_type. Wartości te pochodzą z aktualnego katalogu dokumentów potwierdzających. Identyfikatory są nieprzezroczyste; kopiuj je zamiast tworzyć je samodzielnie lub generować za pomocą funkcji skrótu. Pusty katalog również może zostać zwrócony pomyślnie. Nie zapisuj na stałe w kodzie pełnego wyliczenia typów podmiotów na podstawie tego przykładu.

Przykładowa struktura odpowiedzi; nie są to bieżące dane konta ani aktualna wycena.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "PROOF_TYPE_ID_FROM_RESPONSE",
      "name": "Example proof category",
      "entity_type": "ENTITY_TYPE_FROM_RESPONSE"
    }
  ]
}

Błędy

• Sprawdź status.code i status.msg pod kątem błędów uwierzytelniania lub usługi. Pomyślne zwrócenie pustego katalogu nie oznacza zatwierdzenia dokumentu ani zwolnienia z obowiązku rejestracji.

Dostępność i skutki uboczne

• To zapytanie o katalog lub wymagania nie tworzy tożsamości, nie przesyła dokumentu potwierdzającego, nie rejestruje numeru ani nie składa zamówienia.
• Pomyślna odpowiedź z katalogiem nie oznacza zatwierdzenia Twoich dokumentów ani potwierdzenia, że wybrany numer można aktywować.