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

GET/v3/get_document_number_types/{country}

Λίστα τύπων αριθμών για καταχώριση

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

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

Επιλέξτε έναν τύπο με βάση το όνομα που επιστρέφεται

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

Το πλήθος των ομάδων δεν είναι απόθεμα αριθμών

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

Αίτημα

Χρησιμοποιήστε τα διαπιστευτήρια του ενεργοποιημένου λογαριασμού σας 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_document_number_types/$COUNTRY_ISO"
Παράμετροι διαδρομής
ΌνομαΤύποςΥποχρεωτικήΠεριγραφή
countrystringΝαιΚωδικός χώρας ISO δύο γραμμάτων από τον κατάλογο χωρών καταχώρισης. Αφαιρούνται τα κενά από την αρχή και το τέλος του και μετατρέπεται σε κεφαλαία.

Απόκριση

Ελέγξτε το status.code στο σώμα JSON καθώς και την κατάσταση HTTP. Το response είναι ένας πίνακας που περιέχει τα id, name και available_groups. Χρησιμοποιήστε το name ως number_type κατά την κλήση του get_requirements· μην στείλετε το id στη θέση του. Το available_groups είναι το πλήθος των εγγραφών ομάδων που επιστρέφονται για τον συγκεκριμένο τύπο, όχι το πλήθος των τηλεφωνικών αριθμών στο απόθεμα ούτε το πλήρες σύνολο από όλες τις σελίδες αποτελεσμάτων. Οι τύποι για τους οποίους δεν επιστρέφονται ομάδες παραλείπονται. Η προτιμώμενη σειρά είναι Local, Mobile, National, Toll Free, Shared Cost, Global και ακολουθούν τα υπόλοιπα ονόματα του καταλόγου.

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

Σφάλματα

  • 400: country is required: δώστε τον κωδικό ISO της χώρας καταχώρισης.
  • 400: Invalid country ISO or no available DID registration country found: επιλέξτε μια χώρα από τον τρέχοντα κατάλογο καταχώρισης· αυτό δεν τεκμηριώνει ότι δεν απαιτούνται έγγραφα.

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

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