Λίστα χωρών του καταλόγου (παλαιά μορφή)

Αυτό το παλαιό τελικό σημείο επιστρέφει σώμα απόκρισης της μορφής {"code", "data"} αντί για το τυπικό περίβλημα status/response. Παραθέτει τις ορατές χώρες που συνδέονται με τον κατάλογο ειδικών αριθμών και δεν ελέγχει τη διαθεσιμότητα αριθμών.

Για νέες ενσωματώσεις:

• Χρησιμοποιήστε το GET /v3/getcountries για να βρείτε χώρες με διαθέσιμους αριθμούς.
• Χρησιμοποιήστε το GET /v3/other/{isocode} για να δείτε ποιοι τύποι ειδικών αριθμών προσφέρονται πράγματι σε μια χώρα. Μια χώρα που εμφανίζεται εδώ μπορεί παρ' όλα αυτά να επιστρέφει κενό κατάλογο σε εκείνο το τελικό σημείο.

Αίτημα

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

GET χωρίς παραμέτρους και χωρίς σώμα αιτήματος.

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

Απόκριση

Σώμα απόκρισης παλαιάς μορφής χωρίς το τυπικό περίβλημα: {code: 200, data: [...]}. Δεν υπάρχει αντικείμενο status ούτε πεδίο msg ή results. Το data παραθέτει τις χώρες χωρίς εγγυημένη σειρά. Πεδία: countrycode (τηλεφωνικός κωδικός χώρας χωρίς '+'), name, description (ίδια τιμή με το name), isocode, latitude και longitude. Δεν υπάρχουν πεδία is_mobile, sms_coverage ή next_function. Μια χώρα περιλαμβάνεται στη λίστα όταν είναι ορατή και συνδέεται με τον κατάλογο ειδικών αριθμών. Η διαθεσιμότητα δεν ελέγχεται, επομένως μια χώρα που περιλαμβάνεται στη λίστα ενδέχεται να μην έχει διαθέσιμους αριθμούς αυτή τη στιγμή. Αν καμία χώρα δεν πληροί τα κριτήρια, το data είναι null.

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

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

Σφάλματα

• 401: Ο έλεγχος ταυτότητας λείπει ή απέτυχε. Η απόκριση αποστέλλεται με HTTP status 401 στο τυπικό περίβλημα status/response, όχι στο σώμα απόκρισης παλαιάς μορφής.

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

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