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

GET/v3/get_proof_types

Λίστα κατηγοριών αποδεικτικών εγγράφων

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

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

Επιλέξτε κατηγορία αποδεικτικών εγγράφων

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

Καλύψτε τις πραγματικές απαιτήσεις

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

Αίτημα

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

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

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_proof_types"

Απόκριση

Ελέγξτε το status.code στο σώμα JSON, καθώς και την κατάσταση HTTP. Το response είναι ένας πίνακας αντικειμένων με τα πεδία id, name και entity_type. Αυτές οι τιμές προέρχονται από τον τρέχοντα κατάλογο αποδεικτικών εγγράφων. Τα αναγνωριστικά είναι αδιαφανείς τιμές· αντιγράψτε τα αντί να τα κατασκευάσετε ή να τα δημιουργήσετε μέσω συνάρτησης κατακερματισμού. Είναι δυνατή η επιτυχής επιστροφή ενός κενού καταλόγου. Μην ενσωματώνετε σταθερά στον κώδικα μια πλήρη απαρίθμηση τύπων οντοτήτων με βάση αυτό το παράδειγμα.

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "PROOF_TYPE_ID_FROM_RESPONSE",
      "name": "Example proof category",
      "entity_type": "ENTITY_TYPE_FROM_RESPONSE"
    }
  ]
}

Σφάλματα

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

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

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