Wyświetlanie dostępnych odwołań do przesłanych plików
Użyj tego punktu końcowego po przesłaniu dokumentów rejestracyjnych, gdy potrzebujesz znaleźć odwołania, których nadal można użyć do dołączenia plików. Korzystaj z aktywnego konta API MultiTEL przez HTTPS, z danymi uwierzytelniającymi i ograniczeniami adresów IP skonfigurowanymi dla tego konta. Lista obejmuje wyłącznie Twoje konto.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesTreść żądania ani parametry zapytania nie są wymagane. Procedura obsługi wyświetla rekordy przesłanych plików utworzone przez API, dla których flaga wygaśnięcia nie jest ustawiona, a czas wygaśnięcia jest późniejszy niż bieżący czas serwera. Nie udostępnia parametrów stronicowania, wyszukiwania ani sortowania. Nie jest to lista wszystkich tożsamości, dokumentów potwierdzających ani dokumentów historycznych na Twoim koncie.
Odczytuj metadane, a nie bajty dokumentów
Sprawdź wynik HTTP oraz pole status.code w danych JSON. W poprawnej odpowiedzi pole response zawiera tablicę; pusty wynik to pusta tablica, a nie błąd braku konta. W przykładzie użyto fikcyjnych metadanych i identyfikatorów.
{
"status": {"code": 200, "msg": ""},
"response": [{
"id": "0123456789abcdef0123456789abcdef",
"proof_type": "abcdef0123456789abcdef0123456789",
"entity_type": "addresses",
"description": "Example address proof",
"file_name": "example-document.pdf",
"date": "2026-10-01 12:00:00"
}]
}| Pole | Znaczenie |
|---|---|
id | Zewnętrzne odwołanie do przesłanego pliku. Skopiuj je dokładnie do odpowiedniego żądania dołączenia. Nie obliczaj identyfikatora samodzielnie ani nie zastępuj tego odwołania identyfikatorem tożsamości, adresu lub szablonu. |
proof_type | Zamaskowane zapisane odwołanie do typu, jeśli istnieje; w przeciwnym razie pusty ciąg znaków. W przypadku przesłanych dokumentów potwierdzających jest to typ dokumentu potwierdzającego; w przypadku przesłanych dokumentów uzupełniających pod tym samym kluczem zapisywane jest odwołanie do szablonu. Odczytaj entity_type, aby je rozróżnić. Nie jest to identyfikator przesłanego pliku. |
entity_type | Zapisana kategoria dołączenia, na przykład identities, addresses lub supporting_documents. Wybierz odpowiadający jej proces dołączania. |
description | Zapisany opis przesłanego pliku. |
file_name | Oryginalna nazwa pliku. Nie jest to adres URL do pobrania. |
date | Zapisany czas utworzenia, sformatowany przez serwer bez przesunięcia strefy czasowej. |
Odpowiedź nie zawiera bajtów dokumentu, adresu URL miejsca przechowywania ani terminu wygaśnięcia. Zachowaj expired_at z pierwotnej odpowiedzi na przesłanie pliku. Wyświetlenie przesłanego pliku na liście nie przedłuża jego ważności, nie dołącza go do tożsamości ani nie dowodzi, że operator go zatwierdził.
Dołącz plik przed wygaśnięciem odwołania
Wybierz odpowiedni proces: dołączanie dokumentu potwierdzającego lub dołączanie dokumentu uzupełniającego. W obecnym procesie przesyłania plików odwołania mają krótki okres ważności; nie odkładaj dołączenia tylko dlatego, że odwołanie pojawiło się na tej liście. Odwołanie może wygasnąć lub stać się niedostępne między wyświetleniem listy a dołączeniem pliku. Obsłuż odpowiedź na żądanie dołączenia, zamiast zakładać powodzenie.
Jeśli lista jest nieoczekiwanie pusta, sprawdź konto oraz to, czy przesłany plik wygasł lub został przesłany w ramach innego procesu. Nie przesyłaj automatycznie ponownie tych samych dokumentów bez sprawdzenia wyników pierwotnego przesłania i dołączenia.
Prywatność
Nazwy plików i opisy mogą umożliwiać identyfikację osób lub dokumentów, mimo że zawartość plików nie jest udostępniana. Ogranicz dostęp i unikaj zapisywania całych odpowiedzi w dziennikach. Aby usunąć nieużywane lokalne odwołanie do przesłanego pliku, zobacz usuwanie odwołania do przesłanego pliku; ta operacja nie zapewnia kompleksowego usuwania dokumentów.