Αντικατάσταση των επεξεργάσιμων στοιχείων ενός προφίλ
Ενημερώστε ένα υπάρχον προφίλ εγγραφής που ανήκει στον λογαριασμό, χρησιμοποιώντας το τοπικό UUID του από το create_document ή το documents. Αυτή η λειτουργία αλλάζει τα δεδομένα του λογαριασμού και τα δεδομένα στον ανάντη τηλεπικοινωνιακό πάροχο. Δεν αλλάζει τον αποθηκευμένο τύπο ταυτότητας Personal/Business και δεν αποτελεί PATCH για επιμέρους πεδία.
Αίτημα ενημέρωσης
Πραγματοποιήστε έλεγχο ταυτότητας με τον ενεργοποιημένο λογαριασμό σας στο API της MultiTEL από επιτρεπόμενη διεύθυνση IP. Τα παραδείγματα χρησιμοποιούν διαπιστευτήρια σε μεταβλητές περιβάλλοντος και εικονικά δεδομένα. Διαβάστε τα πεδία JSON status.code και status.msg, καθώς και την απόκριση HTTP.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--header 'Content-Type: application/json' \
--data @registration-profile-update.json \
"https://api.multitel.net/v3/update_document/$DOCUMENT_UUID"{
"first_name": "Example",
"last_name": "Person",
"phone_number": "12025550123",
"email": "end-user@example.com",
"city": "Example City",
"postal_code": "00000",
"address": "1 Example Street",
"country": "US",
"nationality": "US",
"signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE",
"id_number": "",
"personal_tax_id": "",
"birth_date": "",
"description": "Example profile",
"company_name": "",
"company_reg_number": "",
"incorporation_country": "",
"vat_id": "",
"address_description": ""
}Το παράδειγμα παρουσιάζει ένα προφίλ Personal· αντικαταστήστε το με όλα τα επιθυμητά στοιχεία του τελικού χρήστη και την εξουσιοδοτημένη υπογραφή του. Μην υποβάλλετε υπογραφές υποκατάστασης ή κενές τιμές ως μέσο διατήρησης των δεδομένων. Υποστηρίζονται δεδομένα εισόδου JSON και δεδομένα με κωδικοποίηση φόρμας.
| Πεδία | Συμπεριφορά |
|---|---|
| first_name, last_name, city, postal_code, address | Υποχρεωτικά· έως 64 χαρακτήρες το καθένα. |
| phone_number | Υποχρεωτική αριθμητική τιμή τουλάχιστον οκτώ χαρακτήρων· χρησιμοποιήστε τα ψηφία του αριθμού σε διεθνή μορφή, συμπεριλαμβανομένου του κωδικού χώρας. |
| signature | Υποχρεωτική. Η πύλη παρέχει τα byte PNG με κωδικοποίηση Base64 χωρίς το πρόθεμα του URL δεδομένων. |
| country | Δώστε έναν κωδικό ISO για τη χώρα της διεύθυνσης από τον κατάλογο εγγραφής. Ο χειριστής τον αντιστοιχίζει στην αντίστοιχη χώρα, αν και η ενημέρωση διεύθυνσης που εξετάστηκε δεν αλλάζει τη συσχέτιση με τη χώρα. |
| nationality | Υποχρεωτικός κωδικός ISO χώρας για υπάρχον προφίλ Personal. |
| company_name, incorporation_country | Υποχρεωτικά για υπάρχον προφίλ Business· η επωνυμία της εταιρείας πρέπει να έχει έως 64 χαρακτήρες και η χώρα σύστασης να δηλώνεται με κωδικό ISO. |
| Προαιρετική έγκυρη διεύθυνση ηλεκτρονικού ταχυδρομείου έως 254 χαρακτήρες. Παραλείψτε την για να διατηρήσετε την αποθηκευμένη διεύθυνση επικοινωνίας· στείλτε κενή τιμή για να τη διαγράψετε τοπικά. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | Στείλτε τις επιθυμητές τρέχουσες τιμές. Οι τιμές που παραλείπονται ορίζονται από προεπιλογή ως κενές και μπορούν να αντικαταστήσουν ήδη αποθηκευμένες τιμές. |
Οι κανόνες εγγραφής κάθε χώρας ενδέχεται να απαιτούν πρόσθετες πληροφορίες ή μορφές δεδομένων. Μην ανασυνθέτετε μια πλήρη ενημέρωση από το get_document και μόνο: η περιορισμένη απόκρισή του παραλείπει τους επιλογείς χώρας, το email και τα αναγνωριστικά οντοτήτων. Διατηρήστε τα αρχικά δεδομένα που έχετε εξουσιοδότηση να χρησιμοποιείτε ή χρησιμοποιήστε το πρόγραμμα επεξεργασίας εγγράφων της πύλης.
Για προχωρημένους: προσθήκη ήδη μεταφορτωμένων αποδεικτικών
Οι προαιρετικοί πίνακες identity_encryptfiles και address_encryptfiles δέχονται ενεργές αναφορές που ανήκουν στον λογαριασμό από το create_encrypt_files. Χρησιμοποιήστε την ίδια κατηγορία οντότητας με εκείνη της μεταφόρτωσης και υποβάλετε το αίτημα πριν λήξει η αναφορά. Κάθε αρχείο επισυνάπτεται σε ξεχωριστό αίτημα αποδεικτικού, ακόμη και αν περισσότερα αρχεία έχουν τον ίδιο τύπο αποδεικτικού. Για αποδεικτικό ταυτότητας με πολλά αρχεία, χρησιμοποιήστε τη μεταγενέστερη ροή εργασίας για επισύναψη αποδεικτικών με έναν πίνακα.
Αν ένα μεταγενέστερο αποδεικτικό διεύθυνσης απορριφθεί για μια νεοδημιουργημένη διεύθυνση, μην αντικαθιστάτε το UUID του προφίλ και μην δημιουργείτε ξανά την ταυτότητα επανειλημμένα. Σταματήστε και ελέγξτε το προφίλ στην πύλη ή με την υποστήριξη. Η διαδρομή ανάγνωσης/αναζήτησης αποδεικτικού διεύθυνσης παραμένει περιορισμός της εξέτασης.
Αποκρίσεις επιτυχίας και αποτυχίας παλαιότερης μορφής
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}Ο συνήθης κωδικός επιτυχίας αυτού του τελικού σημείου είναι η συμβολοσειρά success, αντί για την αριθμητική τιμή 200. Μια συνήθης αποτυχία στον ανάντη πάροχο ή τοπικά μπορεί να χρησιμοποιεί τη συμβολοσειρά error. Ο αριθμητικός κωδικός 400 καλύπτει μη έγκυρα πεδία ή αποτυχίες αποδεικτικών, ο 404 προφίλ που λείπει ή μη έγκυρη αναφορά μεταφορτωμένου αρχείου και ο 500 κενό σώμα ή χώρα που δεν μπόρεσε να αντιστοιχιστεί. Διαβάστε το μήνυμα και τυχόν καταχωρίσεις επικύρωσης· μη θεωρείτε το HTTP 200 από μόνο του ένδειξη επιτυχίας.
Τρέχοντες περιορισμοί ενημέρωσης και ανάκαμψη
Μια αναφερόμενη επιτυχία δεν εγγυάται ότι άλλαξαν όλα τα πεδία στον ανάντη πάροχο. Ο κώδικας που εξετάστηκε μπορεί να αποθηκεύσει το τοπικό προφίλ μετά την αποτυχία ενημέρωσης της διεύθυνσης στον ανάντη πάροχο. Η ενημέρωση ταυτότητας στον ανάντη πάροχο δεν περιλαμβάνει το email. Η συγκεκριμένη διαδρομή δεν διασφαλίζει αλλαγές στη χώρα της διεύθυνσης ούτε συγχρονισμό της περιγραφής της διεύθυνσης. Αν χρειάζεστε αυτές τις αλλαγές, ελέγξτε το αποτέλεσμα στην πύλη και επικοινωνήστε με την υποστήριξη, αντί να θεωρήσετε ότι ενημερώθηκε η εγγραφή στον ανάντη πάροχο.
Η ενημέρωση δεν αποτελεί μία ενιαία ατομική συναλλαγή: οι αλλαγές ταυτότητας και οι επισυνάψεις αποδεικτικών μπορούν να προηγηθούν μιας μεταγενέστερης αποτυχίας. Δεν παρέχεται κλειδί ιδιοδυναμίας. Μετά από αβέβαιη απόκριση, ελέγξτε το προφίλ και τα συνημμένα πριν προσπαθήσετε ξανά· οι επαναλαμβανόμενες υποβολές αποδεικτικών μπορούν να δημιουργήσουν διπλότυπα. Η ενημέρωση ενός προφίλ δεν συνεπάγεται έγκριση των αποδεικτικών ούτε ενεργοποιεί έναν αριθμό.