Επισύναψη δικαιολογητικού

Επισυνάψτε ένα δικαιολογητικό που βασίζεται σε πρότυπο

Χρησιμοποιήστε ένα πρότυπο από το get_supporting_document_templates και μια ταυτότητα που ανήκει ήδη στον λογαριασμό σας. Μεταφορτώστε τα αρχεία του εγγράφου μέσω του create_encrypt_files χρησιμοποιώντας το supporting_template_id. Οι συνήθεις μεταφορτώσεις αποδεικτικών ταυτότητας ή διεύθυνσης ανήκουν σε διαφορετική κατηγορία και δεν μπορούν να χρησιμοποιηθούν στη θέση τους.

Δημιουργήστε το δικαιολογητικό

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @supporting-request.json \
  https://api.multitel.net/v3/create_supporting_document

{
  "identity_id": "33333333333333333333333333333333",
  "template_id": "55555555555555555555555555555555",
  "encrypted_file_ids": [
    "66666666666666666666666666666666"
  ]
}

Πεδία αιτήματος
Πεδίο	Σημασία
`identity_id`	Υποχρεωτικό αναγνωριστικό της ταυτότητας που σχετίζεται με τον λογαριασμό σας. Αυτό το αίτημα επισυνάπτει το έγγραφο σε μια ταυτότητα, όχι απευθείας σε μια διεύθυνση ή έναν αριθμό τηλεφώνου.
`template_id`	Υποχρεωτικό αναγνωριστικό προτύπου δικαιολογητικού· χρησιμοποιήστε το ίδιο επιλεγμένο πρότυπο με αυτό της μεταφόρτωσης του δικαιολογητικού. Το πεδίο επισύναψης είναι το template_id, ενώ το πεδίο μεταφόρτωσης είναι το supporting_template_id.
`encrypted_file_ids`	Υποχρεωτικός μη κενός πίνακας JSON με τα αναγνωριστικά μεταφορτώσεων που επιστράφηκαν. Κάθε μεταφόρτωση πρέπει να ανήκει στον τρέχοντα λογαριασμό, να μην έχει λήξει και να ανήκει στην κατηγορία supporting_documents.

Γίνονται επίσης δεκτά δεδομένα φόρμας με επαναλαμβανόμενα πεδία encrypted_file_ids[]. Μη στέλνετε τα byte των αρχείων σε αυτό το τελικό σημείο επισύναψης.

Το δικαιολογητικό δημιουργήθηκε

{
  "status": {
    "code": 200,
    "msg": "Supporting document created successfully."
  },
  "response": {
    "id": "77777777777777777777777777777777",
    "template_id": "55555555555555555555555555555555",
    "identity_id": "33333333333333333333333333333333",
    "template_name": "Example supporting template"
  }
}

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

Σφάλματα και επαναλήψεις αιτημάτων

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

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