Λίστα διαθέσιμων μεταφορτώσεων για την εγγραφή

Λίστα διαθέσιμων αναφορών μεταφορτώσεων

Χρησιμοποιήστε αυτό το τελικό σημείο μετά τη μεταφόρτωση εγγράφων εγγραφής όταν χρειάζεται να βρείτε αναφορές που παραμένουν διαθέσιμες για επισύναψη. Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API MultiTEL μέσω HTTPS, με τα διαπιστευτήρια και τους περιορισμούς IP που έχουν ρυθμιστεί για αυτόν. Η λίστα περιορίζεται στον λογαριασμό σας.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/get_encrypted_files

Δεν απαιτούνται σώμα αιτήματος ή παράμετροι ερωτήματος. Ο χειριστής παραθέτει τις εγγραφές μεταφορτώσεων που δημιουργήθηκαν μέσω API, των οποίων η σημαία λήξης δεν είναι ενεργοποιημένη και των οποίων ο χρόνος λήξης είναι μεταγενέστερος από την τρέχουσα ώρα του διακομιστή. Δεν παρέχει παραμέτρους σελιδοποίησης, αναζήτησης ή ταξινόμησης. Δεν πρόκειται για λίστα όλων των ταυτοτήτων, των αποδεικτικών ή των παλαιότερων εγγράφων του λογαριασμού σας.

Ανάγνωση μεταδεδομένων, όχι των byte των εγγράφων

Διαβάστε το αποτέλεσμα HTTP και το πεδίο status.code στο περιεχόμενο JSON. Μια επιτυχής απόκριση περιέχει έναν πίνακα στο response· ένα κενό αποτέλεσμα είναι ένας κενός πίνακας, όχι σφάλμα ανύπαρκτου λογαριασμού. Το παράδειγμα χρησιμοποιεί εικονικά μεταδεδομένα και αναγνωριστικά.

{
  "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"
  }]
}

Πεδία μεταδεδομένων μεταφόρτωσης
Πεδίο	Σημασία
`id`	Η εξωτερική αναφορά της μεταφόρτωσης. Αντιγράψτε την ακριβώς στο αντίστοιχο αίτημα επισύναψης. Μην υπολογίζετε μόνοι σας κάποιο αναγνωριστικό και μην την αντικαθιστάτε με αναγνωριστικό ταυτότητας, διεύθυνσης ή προτύπου.
`proof_type`	Η αναφορά του καταγεγραμμένου τύπου σε καλυμμένη μορφή, όταν υπάρχει, διαφορετικά μια κενή συμβολοσειρά. Για τις μεταφορτώσεις αποδεικτικών, πρόκειται για τον τύπο αποδεικτικού· οι μεταφορτώσεις υποστηρικτικών εγγράφων καταγράφουν την αναφορά του προτύπου τους στο ίδιο κλειδί. Διαβάστε το entity_type για να τις διακρίνετε. Δεν είναι το αναγνωριστικό της μεταφόρτωσης.
`entity_type`	Η καταγεγραμμένη κατηγορία επισύναψης, όπως identities, addresses ή supporting_documents. Επιλέξτε την αντίστοιχη ροή επισύναψης.
`description`	Η αποθηκευμένη περιγραφή της μεταφόρτωσης.
`file_name`	Το αρχικό όνομα του αρχείου. Δεν είναι διεύθυνση URL λήψης.
`date`	Η καταγεγραμμένη ημερομηνία και ώρα δημιουργίας, με μορφοποίηση από τον διακομιστή χωρίς ένδειξη απόκλισης ζώνης ώρας.

Η απόκριση δεν περιέχει byte εγγράφων, διεύθυνση URL αποθήκευσης ή χρονικό όριο λήξης. Διατηρήστε το expired_at από την αρχική απόκριση της μεταφόρτωσης. Η εμφάνιση μιας μεταφόρτωσης στη λίστα δεν παρατείνει την ισχύ της, δεν την επισυνάπτει σε κάποια ταυτότητα και δεν αποδεικνύει ότι την έχει εγκρίνει τηλεπικοινωνιακός πάροχος.

Επισύναψη πριν λήξει η αναφορά

Χρησιμοποιήστε την κατάλληλη ροή για επισύναψη αποδεικτικού ή επισύναψη υποστηρικτικού εγγράφου. Η τρέχουσα ροή μεταφόρτωσης δίνει στις αναφορές σύντομο διάστημα ισχύος· μην καθυστερείτε την επισύναψη απλώς επειδή μια αναφορά εμφανίστηκε σε αυτή τη λίστα. Μια αναφορά μπορεί να λήξει ή να μην είναι πλέον διαθέσιμη στο διάστημα μεταξύ της ανάκτησης της λίστας και της επισύναψης. Χειριστείτε την απόκριση της επισύναψης χωρίς να θεωρείτε δεδομένη την επιτυχία.

Αν η λίστα είναι απροσδόκητα κενή, ελέγξτε τον λογαριασμό και αν η μεταφόρτωση έχει λήξει ή δημιουργήθηκε μέσω άλλης ροής. Μην μεταφορτώνετε ξανά αυτόματα τα ίδια έγγραφα χωρίς να ελέγξετε τα αποτελέσματα της αρχικής μεταφόρτωσης και της επισύναψης.

Ιδιωτικότητα

Τα ονόματα αρχείων και οι περιγραφές μπορούν να ταυτοποιήσουν άτομα ή έγγραφα, παρόλο που απουσιάζουν τα περιεχόμενα των αρχείων. Περιορίστε την πρόσβαση και αποφύγετε την καταγραφή ολόκληρων αποκρίσεων στα αρχεία καταγραφής. Για να αφαιρέσετε μια τοπική αναφορά μεταφόρτωσης που δεν χρησιμοποιείται, δείτε την ενότητα αφαίρεση αναφοράς μεταφόρτωσης· αυτή η λειτουργία δεν αποτελεί ολοκληρωμένη υπηρεσία διαγραφής εγγράφων.