Wybierz nieużywane odwołanie do przesłanego pliku
Ten punkt końcowy usuwa rekord odwołania do przesłanego pliku należący do Twojego konta. Używaj go tylko wtedy, gdy masz pewność, że odwołanie nie jest już potrzebne do dołączenia dokumentu potwierdzającego lub dołączenia dokumentu uzupełniającego. Nie usuwa on tożsamości używanej przy rejestracji ani adresu.
Uzyskaj zewnętrzny identyfikator pliku z pierwotnej odpowiedzi na przesłanie pliku lub z listy dostępnych przesłanych plików. Procedura obsługi najpierw wyszukuje ten identyfikator dla Twojego konta, a w razie niepowodzenia korzysta ze starszego sposobu wyszukiwania według identyfikatora dostawcy. Nowe integracje powinny używać zewnętrznego odwołania dokładnie w zwróconej postaci. Treść żądania nie jest wymagana.
Świadomie zażądaj usunięcia
Korzystaj z aktywnego konta API MultiTEL przez HTTPS, używając skonfigurowanych dla niego danych uwierzytelniających i ograniczeń adresów IP. Użyj metody POST, aby Twoja aplikacja traktowała tę operację jako świadomie wprowadzaną zmianę:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefObecna procedura obsługi nie wymusza ograniczenia metody HTTP: żądanie GET również może doprowadzić do usunięcia. Nie udostępniaj tego adresu URL jako zwykłego klikalnego łącza, obrazu, zakładki, podglądu ani celu pobierania z wyprzedzeniem. Wymagaj w aplikacji jawnej czynności usunięcia i nie ponawiaj żądania automatycznie.
Zinterpretuj wynik i jego ograniczenia
Odczytaj zarówno wynik HTTP, jak i pole w formacie JSON o nazwie status.code. Typowa odpowiedź w przypadku powodzenia wygląda następująco:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Kod API 404 z komunikatem Failed, Not found oznacza, że żaden ze sposobów wyszukiwania nie znalazł pasującego odwołania dla tego konta. Ponowne usunięcie może zatem zwrócić 404. Spacje na początku i końcu wartości w ścieżce są usuwane. Nie jest tutaj sprawdzane, czy odwołanie nie wygasło ani czy nie jest używane w innym kroku, dlatego przed jego usunięciem sprawdź swój proces.
Procedura obsługi zgłasza powodzenie po próbie usunięcia z bazy danych, nie sprawdzając, czy usunięcie się powiodło. Traktuj odpowiedź jako zgłoszony wynik, a nie niezależny dowód usunięcia. Jeśli niewygasłe odwołanie utworzone przez API było widoczne w get_encrypted_files, ta lista może pomóc sprawdzić, czy nadal jest widoczne, ale jego brak na liście może również oznaczać wygaśnięcie.
Usunięcie odwołania nie oznacza całkowitego usunięcia danych
Procedura obsługi wykonuje polecenie usunięcia w tabeli odwołań do przesłanych plików. Nie usuwa jawnie zapisanego wiersza z treścią dokumentu, lokalnego przesłanego pliku, dołączonego dokumentu potwierdzającego, tożsamości, dokumentu uzupełniającego ani kopii przechowywanej przez dostawcę. Nie zweryfikowano działania kaskadowego usuwania w bazie danych ani zasad przechowywania danych. Nie przedstawiaj tej operacji użytkownikom jako usunięcia wszystkich kopii ich dokumentu tożsamości ani realizacji żądania całkowitego usunięcia danych.
Po usunięciu lokalnego odwołania późniejsze kroki dołączania dokumentów, które go wymagają, mogą zakończyć się niepowodzeniem. Zachowaj wyniki już zakończonych operacji dołączania, a przy zmianie przesłanych danych rejestracyjnych skorzystaj z odpowiedniego procesu zarządzania tożsamością lub dokumentami potwierdzającymi.