Προγραμματιστές

GET/v3/get_supporting_document_templates/{iso}

Λίστα προτύπων δικαιολογητικών

Βρείτε αναγνωριστικά προτύπων, ονόματα και ενδείξεις χώρας πριν από την προετοιμασία ενός δικαιολογητικού.

Σε αυτή τη σελίδα
  1. Περιηγηθείτε στον κατάλογο προτύπων
  2. Χρησιμοποιήστε τις απαιτήσεις για να επιλέξετε ένα πρότυπο
  3. Αν δεν επιστραφούν πρότυπα
  4. Ελέγξτε το αντίγραφο που κατεβάσατε πριν το χρησιμοποιήσετε
  5. Αίτημα
  6. Απόκριση
  7. Σφάλματα
  8. Διαθεσιμότητα και παρενέργειες

Περιηγηθείτε στον κατάλογο προτύπων

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

Χρησιμοποιήστε τις απαιτήσεις για να επιλέξετε ένα πρότυπο

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

Αν δεν επιστραφούν πρότυπα

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

Ελέγξτε το αντίγραφο που κατεβάσατε πριν το χρησιμοποιήσετε

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

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

Αίτημα

Χρησιμοποιήστε τα διαπιστευτήρια του ενεργοποιημένου λογαριασμού API σας μέσω HTTPS. Υποστηρίζονται ο έλεγχος ταυτότητας Basic και τα ενεργοποιημένα διακριτικά bearer λογαριασμού API· ισχύουν οι περιορισμοί του λογαριασμού.

GET με οποιαδήποτε τεκμηριωμένη παράμετρο στη διαδρομή του URL.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"
Παράμετροι διαδρομής
ΌνομαΤύποςΥποχρεωτικόΠεριγραφή
isostringΌχιΠροαιρετικό φίλτρο κωδικού χώρας ISO. Παραλείψτε ολόκληρο αυτό το τμήμα της διαδρομής για τη λίστα χωρίς φίλτρο. Η σύγκριση δεν κάνει διάκριση πεζών και κεφαλαίων. Άγνωστες τιμές ή τιμές χωρίς αντιστοιχία επιστρέφουν κενή λίστα αντί για ρητό σφάλμα μη έγκυρης χώρας.

Απόκριση

Ελέγξτε το status.code στο σώμα JSON καθώς και την κατάσταση HTTP. Το response είναι ένας πίνακας αντικειμένων με id, name, permanent, iso και url. Το permanent είναι τύπου boolean· το iso μπορεί να είναι κενό και μπορεί να έχει συναχθεί από το όνομα του προτύπου. Αντιμετωπίστε τις πληροφορίες χώρας ως ένδειξη, όχι ως απόφαση επιλεξιμότητας. Ένας κενός κατάλογος αποτελεί επιτυχή απόκριση 200 και μπορεί επίσης να προκύψει όταν η αναζήτηση στην ανάντη υπηρεσία δεν αποδίδει δεδομένα. Το URL δημιουργείται από την υπηρεσία· το όνομα κεντρικού υπολογιστή του μπορεί να διαφέρει από εκείνο του ενδεικτικού παραδείγματος.

Ενδεικτική δομή απόκρισης· δεν πρόκειται για δεδομένα λογαριασμού σε πραγματικό χρόνο ή για τρέχουσα προσφορά τιμής.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "TEMPLATE_ID_FROM_RESPONSE",
      "name": "Example supporting-document template",
      "permanent": false,
      "iso": "US",
      "url": "https://api.multitel.net/v3/supporting_document/TEMPLATE_ID_FROM_RESPONSE"
    }
  ]
}

Σφάλματα

  • Ελέγξτε τα status.code και status.msg για σφάλματα ελέγχου ταυτότητας ή υπηρεσίας. Η επιτυχής επιστροφή κενού καταλόγου δεν αποτελεί έγκριση εγγράφου ή απαλλαγή από την υποχρέωση καταχώρισης.

Διαθεσιμότητα και παρενέργειες

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