Λίστα χωρών με αριθμούς σε απόθεμα

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

• Διαβιβάστε το isocode στο getareas, στο getstates (μόνο για US και CA) ή στο other.
• next_function παραπέμπει πάντα στο v3/getareas/{isocode}. Για τις Ηνωμένες Πολιτείες και τον Καναδά, μπορείτε να καλέσετε το getstates πρώτα, για να περιορίσετε την αναζήτηση ανά πολιτεία ή επαρχία.
• is_mobile και sms_coverage είναι ενδείξεις σε επίπεδο χώρας και δεν αποτελούν εγγύηση για κάθε αριθμό. Για τις Ηνωμένες Πολιτείες, το is_mobile είναι 0 εκτός αν ο λογαριασμός σας έχει ενεργοποιηθεί για αριθμούς κινητής τηλεφωνίας των ΗΠΑ.
• Οι χώρες με κάλυψη αποκλειστικά κατόπιν παραγγελίας δεν εμφανίζονται στη λίστα. Μπορείτε παρ' όλα αυτά να καλέσετε το getareas ή το other απευθείας για μια χώρα που δεν εμφανίζεται στη λίστα.
• Ταξινομήστε εσείς τη λίστα αν χρειάζεστε συγκεκριμένη σειρά.

Αν καμία χώρα δεν πληροί τις προϋποθέσεις, το response είναι null και το status.code είναι 200.

Αίτημα

Απαιτείται: έλεγχος ταυτότητας HTTP Basic ή διακριτικό Bearer (βλ. Έλεγχος ταυτότητας και αποκρίσεις API). Σε περίπτωση αποτυχίας του ελέγχου ταυτότητας, επιστρέφεται απόκριση HTTP 401 πριν εκτελεστεί η αναζήτηση.

GET χωρίς σώμα αιτήματος. Η μοναδική παράμετρος είναι η προαιρετική pid, η οποία αποστέλλεται στη συμβολοσειρά ερωτήματος.

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/getcountries'

Απόκριση

Τυπική εξωτερική δομή απόκρισης. Σε περίπτωση επιτυχίας, το status.code είναι 200, το status.msg είναι 'Results: N', το status.results είναι N και το response είναι μια λίστα χωρών χωρίς εγγυημένη σειρά. Πεδία: countrycode (κωδικός κλήσης χώρας χωρίς '+')· name (όνομα χώρας)· description (ίδια τιμή με το name)· isocode (κωδικός ISO 3166-1 alpha-2)· is_mobile (0 ή 1, ένδειξη καταλόγου σε επίπεδο χώρας, πάντα 0 για US εκτός αν ο λογαριασμός σας έχει ενεργοποιηθεί για αριθμούς κινητής τηλεφωνίας της χώρας US)· sms_coverage (0 ή 1, ένδειξη καταλόγου σε επίπεδο χώρας)· latitude και longitude (συντεταγμένες χώρας)· next_function ('v3/getareas/{isocode}'). Μια χώρα εμφανίζεται στη λίστα μόνο αν είναι ορατή και τουλάχιστον ένα από τα προθέματά της διαθέτει αυτή τη στιγμή αριθμούς σε απόθεμα σε οποιαδήποτε πηγή αποθέματος. Οι χώρες των οποίων η κάλυψη παρέχεται εξ ολοκλήρου κατόπιν παραγγελίας (χωρίς απόθεμα) δεν εμφανίζονται στη λίστα. Αυτός ο έλεγχος αποθέματος είναι ευρύτερος από τα φίλτρα που εφαρμόζει το getareas, επομένως μια χώρα που εμφανίζεται στη λίστα μπορεί περιστασιακά να επιστρέψει εκεί 'No areas found'. Αν καμία χώρα δεν πληροί τις προϋποθέσεις, το status.code είναι 200, το status.msg είναι 'Results: 0', δεν υπάρχει πεδίο status.results και το response είναι null.

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

{
  "status": {
    "code": 200,
    "msg": "Results: 2",
    "results": 2
  },
  "response": [
    {
      "countrycode": "1",
      "name": "United States",
      "description": "United States",
      "isocode": "US",
      "is_mobile": 0,
      "sms_coverage": 1,
      "latitude": "38.0000",
      "longitude": "-97.0000",
      "next_function": "v3/getareas/US"
    },
    {
      "countrycode": "44",
      "name": "United Kingdom",
      "description": "United Kingdom",
      "isocode": "GB",
      "is_mobile": 1,
      "sms_coverage": 0,
      "latitude": "54.0000",
      "longitude": "-2.0000",
      "next_function": "v3/getareas/GB"
    }
  ]
}

Σφάλματα

• 401: Λείπουν τα στοιχεία ελέγχου ταυτότητας ή ο έλεγχος απέτυχε. Αποστέλλεται με κωδικό κατάστασης HTTP 401 (βλ. Έλεγχος ταυτότητας και αποκρίσεις API).

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

• Μόνο αναζήτηση. Δεν δεσμεύει, δεν παραγγέλνει και δεν αλλάζει τίποτα.
• Τα αποτελέσματα αντικατοπτρίζουν το απόθεμα τη στιγμή του αιτήματος και μπορούν να αλλάξουν μεταξύ κλήσεων.