Dołącz potwierdzenie tożsamości lub adresu

Wykonaj ten krok po utworzeniu tożsamości lub adresu i po przesłaniu wymaganych plików za pomocą create_encrypt_files z wybranym typem potwierdzenia. Użyj aktualnego identyfikatora z get_proof_types, zgodnego z wymaganiem i kategorią encji.

Zachowaj identity_id i address_id zwrócone przez create_document; UUID profilu jest innym identyfikatorem. Możliwość późniejszego dołączania potwierdzeń adresu do nowo utworzonych profili jest nadal sprawdzana. Jeśli adres zostanie odrzucony, sprawdź informacje w portalu lub skontaktuj się z pomocą techniczną przed ponowną próbą.

Utwórz potwierdzenie

Użyj aktywnego konta API MultiTEL i dozwolonego dla niego adresu IP. Przykłady korzystają z danych uwierzytelniających HTTP Basic pobieranych ze zmiennych środowiskowych; przestrzegaj zasad uwierzytelniania właściwych dla swojego typu konta. Wysyłaj żądania przez HTTPS. Sprawdzaj zarówno odpowiedź HTTP, jak i pole w obiekcie JSON status.code; błędy aplikacji mogą być zwracane z kodem HTTP 200. Poniższe przykłady są fikcyjne.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Pola żądania
Pole	Znaczenie
`entity_type`	Użyj identities lub addresses. Wybierz kategorię pasującą zarówno do encji docelowej, jak i do przesłanych plików.
`entity_id`	Identyfikator tożsamości lub adresu należących do Twojego konta. Użyj identyfikatora zwróconego w procesie obsługi dokumentów; nie zastępuj go numerem telefonu ani identyfikatorem niepowiązanego dokumentu.
`proof_type_id`	Identyfikator wybranego typu potwierdzenia. Musi być zgodny z typem użytym podczas przesyłania plików oraz z wymaganiem.
`encrypted_file_ids`	Niepusta tablica JSON identyfikatorów plików zwróconych przez create_encrypt_files. Pliki muszą należeć do tego samego konta, nadal być ważne i pasować do kategorii encji. Nie jest to lista lokalnych ścieżek do plików.

Akceptowane są również dane formularza z powtarzającymi się polami encrypted_file_ids[]. Zalecana jest rzeczywista tablica JSON lub tablica formularza; nie wysyłaj tablicy zakodowanej w formacie JSON jako zwykłej skalarnej wartości pola formularza.

Zachowaj identyfikator potwierdzenia

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

Odpowiedź wskazująca powodzenie potwierdza utworzenie powiązania z potwierdzeniem. Nie oznacza zatwierdzenia tożsamości lub adresu, potwierdzenia spełnienia wszystkich wymagań danego kraju ani aktywacji numeru telefonu.

Błędy i przesłane pliki, których ważność wygasła

Kod API 500 jest używany w przypadku braku wymaganych danych wejściowych, awarii po stronie operatora i nieprawidłowej odpowiedzi operatora. Kod 404 jest używany, gdy encja docelowa nie jest powiązana z bieżącym kontem, typ potwierdzenia jest nieprawidłowy, nie można znaleźć przesłanego pliku dla tego konta lub tej kategorii albo ważność pliku wygasła, bądź nie pozostały żadne identyfikatory plików, których można użyć. Odczytuj status.msg razem z kodem.

Przed dołączeniem wymaganego pliku, którego ważność wygasła, prześlij go ponownie, używając właściwej kategorii potwierdzenia. Jeśli którykolwiek z podanych plików jest nieprawidłowy, funkcja obsługująca żądanie zatrzymuje się przed wysłaniem żądania utworzenia potwierdzenia. Klucz idempotencji nie jest udostępniany: po przekroczeniu limitu czasu sprawdź istniejący dokument w portalu, zanim ponownie spróbujesz dołączyć potwierdzenie.