Επισύναψη αποδεικτικού ταυτότητας ή διεύθυνσης

Εκτελέστε αυτό το βήμα αφού δημιουργηθεί η ταυτότητα ή η διεύθυνση και αφού μεταφορτωθούν τα απαιτούμενα αρχεία της μέσω του create_encrypt_files με τον επιλεγμένο τύπο αποδεικτικού. Χρησιμοποιήστε ένα αναγνωριστικό που ισχύει επί του παρόντος από το get_proof_types, το οποίο αντιστοιχεί στην απαίτηση και στην κατηγορία της οντότητας.

Διατηρήστε τα identity_id και address_id από το create_document· το UUID του προφίλ είναι διαφορετικό. Η συμβατότητα της μεταγενέστερης επισύναψης αποδεικτικού διεύθυνσης σε νεοδημιουργημένα προφίλ εξακολουθεί να εξετάζεται. Εάν η διεύθυνση απορριφθεί, ελέγξτε την πύλη ή επικοινωνήστε με την υποστήριξη πριν δοκιμάσετε ξανά.

Δημιουργία του αποδεικτικού

Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό 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 @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Πεδία αιτήματος
Πεδίο	Σημασία
`entity_type`	Χρησιμοποιήστε identities ή addresses. Επιλέξτε την κατηγορία που αντιστοιχεί τόσο στην οντότητα προορισμού όσο και στα μεταφορτωμένα αρχεία.
`entity_id`	Το αναγνωριστικό της ταυτότητας ή της διεύθυνσης που ανήκει στον λογαριασμό σας. Χρησιμοποιήστε το αναγνωριστικό που επιστρέφεται από τη ροή εργασίας των εγγράφων σας· μην το αντικαθιστάτε με αριθμό τηλεφώνου ή με αναγνωριστικό άσχετου εγγράφου.
`proof_type_id`	Το αναγνωριστικό του επιλεγμένου τύπου αποδεικτικού. Πρέπει να συμφωνεί με τη μεταφόρτωση και την απαίτηση.
`encrypted_file_ids`	Μη κενός πίνακας JSON με αναγνωριστικά αρχείων που επιστρέφονται από το create_encrypt_files. Τα αρχεία πρέπει να ανήκουν στον ίδιο λογαριασμό, να μην έχουν λήξει και να αντιστοιχούν στην κατηγορία της οντότητας. Δεν πρόκειται για λίστα διαδρομών τοπικών αρχείων.

Γίνονται επίσης αποδεκτά δεδομένα φόρμας με επαναλαμβανόμενα πεδία encrypted_file_ids[]. Προτιμήστε έναν πραγματικό πίνακα JSON ή έναν πίνακα φόρμας· μη στέλνετε πίνακα κωδικοποιημένο σε JSON ως απλή βαθμωτή τιμή φόρμας.

Διατηρήστε το αναγνωριστικό του αποδεικτικού

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

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

Σφάλματα και ληγμένα μεταφορτωμένα αρχεία

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

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