Μεταφόρτωση αρχείων αποδεικτικών για την εγγραφή

Μεταφορτώστε πριν επισυνάψετε

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

Καθορίστε ακριβώς μία παράμετρο επιλογής: proof_type_id για αποδεικτικό ταυτότητας ή διεύθυνσης ή supporting_template_id για συμπληρωματικό έγγραφο. Μην στέλνετε και τις δύο. Χρησιμοποιήστε αναγνωριστικά που επιστρέφονται από τον αντίστοιχο κατάλογο της MultiTEL· αντιμετωπίστε τα ως αδιαφανή αναγνωριστικά.

Αίτημα μεταφόρτωσης

Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API της MultiTEL και την επιτρεπόμενη διεύθυνση IP του. Τα παραδείγματα χρησιμοποιούν διαπιστευτήρια HTTP Basic από μεταβλητές περιβάλλοντος· ακολουθήστε τις συμβάσεις ελέγχου ταυτότητας για τον τύπο του λογαριασμού σας. Στείλτε τα αιτήματα μέσω HTTPS. Ελέγξτε τόσο την απόκριση HTTP όσο και το πεδίο JSON status.code· τα σφάλματα εφαρμογής μπορεί να επιστρέφονται με HTTP 200. Τα παρακάτω παραδείγματα είναι πλασματικά.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

Πεδία αιτήματος
Πεδίο	Σημασία
`files[0] … files[4]`	Από ένα έως πέντε μεταφορτωμένα αρχεία. Χρησιμοποιήστε δεδομένα φόρμας πολλαπλών μερών και αφήστε το curl να δημιουργήσει το διαχωριστικό όριο του Content-Type. Αυτά τα πεδία περιέχουν τα byte των αρχείων, όχι URL ή δεδομένα Base64 σε JSON.
`proof_type_id`	Απαιτείται για μεταφόρτωση αποδεικτικού· χρησιμοποιήστε ένα αναγνωριστικό τύπου αποδεικτικού που έχει επιστραφεί. Παραλείψτε το supporting_template_id.
`supporting_template_id`	Απαιτείται αντί του proof_type_id για συμπληρωματικά αρχεία· χρησιμοποιήστε ένα αναγνωριστικό προτύπου που έχει επιστραφεί.
`description`	Προαιρετική περιγραφή που παρέχεται από τον καλούντα, έως 100 χαρακτήρες. Σε μεταφόρτωση συμπληρωματικών εγγράφων μπορεί να χρησιμοποιηθεί το όνομα του προτύπου όταν παραλείπεται η περιγραφή.

Όρια αρχείων

Αυτός ο χειριστής δέχεται το πολύ πέντε αρχεία και συνολικά 20,000,000 byte. Πρόκειται για δεκαδικό όριο byte, όχι για 20 MiB. Η υποδομή ή η επικύρωση MIME μπορεί να επιβάλλει πρόσθετα όρια.

Οι επιτρεπόμενες επεκτάσεις είναι pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf και csv. Μια επιτρεπόμενη επέκταση δεν αποδεικνύει ότι ένα αρχείο πληροί την επιλεγμένη απαίτηση εγγραφής. Ειδικότερα, η επέκταση tif δεν περιλαμβάνεται σε αυτή τη λίστα επιτρεπόμενων επεκτάσεων.

Ελέγξτε κάθε αρχείο που επιστρέφεται

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

Κρατήστε κάθε response.ids[].id για το αίτημα επισύναψης. Το πεδίο name προσδιορίζει το όνομα του αρχικού αρχείου που επιστρέφεται. Χρησιμοποιήστε διαφορετικά ονόματα αρχείων και συγκρίνετε τα αρχεία που επιστρέφονται με το αναμενόμενο σύνολο: ο κωδικός 200 μπορεί να αντιστοιχεί σε μια παρτίδα που ολοκληρώθηκε μόνο εν μέρει επιτυχώς. Μην επισυνάπτετε σύνολο από το οποίο λείπουν απαιτούμενα αρχεία.

entity_type έχει τιμή identities ή addresses για αποδεικτικό και supporting_documents για μεταφόρτωση συμπληρωματικών εγγράφων. Το πεδίο document_category έχει τιμή proof ή supporting. Το πεδίο proof_type της απόκρισης, με τη γενική αυτή ονομασία, περιέχει επίσης μια αναφορά σε πρότυπο για μεταφορτώσεις συμπληρωματικών εγγράφων· κρατήστε την αρχική τιμή του supporting_template_id για την επισύναψη.

Επισυνάψτε έγκαιρα

Η υπηρεσία ορίζει τη λήξη περίπου 20 λεπτά μετά την τοπική αποθήκευση της μεταφόρτωσης. Κατά την επισύναψη ελέγχεται ότι το αρχείο ανήκει στον ίδιο λογαριασμό, δεν έχει επισημανθεί ως ληγμένο, δεν έχει ακόμη παρέλθει η λήξη του και έχει τη σωστή κατηγορία οντότητας. Το πεδίο expired_at δεν περιλαμβάνει μετατόπιση ζώνης ώρας σε αυτή την απόκριση· μην θεωρείτε ότι είναι σε UTC. Επισυνάψτε έγκαιρα αντί να προγραμματίζετε την εργασία στο όριο της λήξης.

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

Σφάλματα και επαναπροσπάθειες

Ο τρέχων χειριστής χρησιμοποιεί τον κωδικό API 404 όταν δεν παρέχονται αρχεία εγγράφων και τον κωδικό 500 για προβλήματα επικύρωσης της περιγραφής, παραμέτρους επιλογής που λείπουν ή συγκρούονται, μη έγκυρα αναγνωριστικά τύπων αποδεικτικών ή προτύπων, υπέρβαση του ορίου πλήθους αρχείων ή συνολικού μεγέθους, προβλήματα αποθήκευσης ή αποτυχημένη μεταφόρτωση. Διαβάστε το status.msg· τα μη έγκυρα δεδομένα εισόδου δεν αντιπροσωπεύονται πάντα από τον κωδικό 400.

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