Επιλέξτε μια αχρησιμοποίητη αναφορά μεταφόρτωσης
Αυτό το τελικό σημείο αφαιρεί μια εγγραφή αναφοράς μεταφόρτωσης που ανήκει στον λογαριασμό σας. Χρησιμοποιήστε το μόνο όταν είστε βέβαιοι ότι η αναφορά δεν χρειάζεται πλέον για επισύναψη αποδεικτικού ή επισύναψη δικαιολογητικού εγγράφου. Δεν διαγράφει ταυτότητα ή διεύθυνση που σχετίζεται με την εγγραφή.
Βρείτε το εξωτερικό αναγνωριστικό του αρχείου από την αρχική απόκριση μεταφόρτωσης ή τη λίστα διαθέσιμων μεταφορτώσεων. Ο χειριστής αναζητά πρώτα αυτό το αναγνωριστικό για τον λογαριασμό σας και, αν δεν το βρει, χρησιμοποιεί εναλλακτικά το αναγνωριστικό παρόχου του παλαιού συστήματος. Οι νέες ενσωματώσεις θα πρέπει να χρησιμοποιούν την εξωτερική αναφορά ακριβώς όπως επιστρέφεται. Δεν απαιτείται σώμα αιτήματος.
Ζητήστε την αφαίρεση με συνειδητή ενέργεια
Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API της MultiTEL μέσω HTTPS, με τα διαπιστευτήρια και τους περιορισμούς IP που έχουν ρυθμιστεί για αυτόν. Χρησιμοποιήστε POST ώστε η εφαρμογή σας να αντιμετωπίζει αυτή την ενέργεια ως συνειδητή αλλαγή:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefΟ τρέχων χειριστής δεν επιβάλλει περιορισμό στη μέθοδο HTTP: ένα αίτημα GET μπορεί επίσης να οδηγήσει σε διαγραφή. Μην εκθέτετε αυτό το URL ως συνηθισμένο σύνδεσμο στον οποίο μπορεί να γίνει κλικ, εικόνα, σελιδοδείκτη ή προορισμό προεπισκόπησης ή προφόρτωσης. Απαιτήστε μια ρητή ενέργεια αφαίρεσης στην εφαρμογή σας και μην επαναλαμβάνετε την προσπάθεια αυτόματα.
Ερμηνεύστε το αποτέλεσμα και τους περιορισμούς του
Διαβάστε τόσο το αποτέλεσμα HTTP όσο και το πεδίο status.code στο JSON. Η συνήθης απόκριση επιτυχίας είναι:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Ο κωδικός API 404 με Failed, Not found σημαίνει ότι καμία από τις δύο αναζητήσεις δεν βρήκε αντίστοιχη αναφορά για αυτόν τον λογαριασμό. Επομένως, μια επανάληψη της αφαίρεσης ενδέχεται να επιστρέψει 404. Τα κενά στην αρχή και στο τέλος της τιμής της διαδρομής αφαιρούνται. Εδώ δεν ελέγχεται αν η αναφορά δεν έχει λήξει ή αν δεν χρησιμοποιείται από άλλο βήμα, επομένως επιβεβαιώστε τη ροή εργασίας σας πριν την αφαιρέσετε.
Ο χειριστής αναφέρει επιτυχία αφού επιχειρήσει τη διαγραφή από τη βάση δεδομένων, χωρίς να ελέγχει αν η διαγραφή πέτυχε. Αντιμετωπίστε την απόκριση ως το αναφερόμενο αποτέλεσμα και όχι ως ανεξάρτητη απόδειξη διαγραφής. Αν μια αναφορά που δημιουργήθηκε μέσω API και δεν είχε λήξει εμφανιζόταν στο get_encrypted_files, αυτή η λίστα μπορεί να βοηθήσει στον έλεγχο του αν εξακολουθεί να εμφανίζεται, αλλά η απουσία της από τη λίστα μπορεί επίσης να σημαίνει ότι έληξε.
Η αφαίρεση δεν αποτελεί πλήρη διαγραφή δεδομένων
Ο χειριστής εκτελεί μια εντολή διαγραφής στον πίνακα αναφορών μεταφόρτωσης. Δεν διαγράφει ρητά την αποθηκευμένη γραμμή με το περιεχόμενο του εγγράφου, το τοπικά μεταφορτωμένο αρχείο, το συνημμένο αποδεικτικό, την ταυτότητα, το δικαιολογητικό έγγραφο ή το αντίγραφο που διατηρεί ο πάροχος. Η συμπεριφορά των διαδοχικών ενεργειών στη βάση δεδομένων και της διατήρησης δεδομένων δεν έχει επαληθευτεί. Μην παρουσιάζετε αυτή τη λειτουργία στους χρήστες ως διαγραφή όλων των αντιγράφων του εγγράφου ταυτότητάς τους ή ως ικανοποίηση αιτήματος πλήρους διαγραφής.
Μόλις αφαιρεθεί η τοπική αναφορά, μεταγενέστερα βήματα επισύναψης που τη χρειάζονται ενδέχεται να αποτύχουν. Διατηρήστε τα αποτελέσματα των επισυνάψεων που έχουν ήδη ολοκληρωθεί και χρησιμοποιήστε την κατάλληλη ροή διαχείρισης ταυτότητας ή αποδεικτικών όταν αλλάζετε στοιχεία εγγραφής που έχουν υποβληθεί.