Δείτε τις απαιτήσεις καταχώρισης

Επιλέξτε τη χώρα και τον τύπο αριθμού

Επιλέξτε μια χώρα καταχώρισης και, στη συνέχεια, χρησιμοποιήστε ένα όνομα που επιστρέφεται από το get_document_number_types. Στείλτε αυτό το όνομα ως number_type, όχι ένα αναγνωριστικό τύπου ή μια γενική κατηγορία αναζήτησης αριθμών.

Διαβάστε τις οδηγίες που επιστρέφονται

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

Μην ερμηνεύετε ένα σφάλμα ως απαλλαγή

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

Αίτημα

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

POST με application/json ή application/x-www-form-urlencoded.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header "Content-Type: application/json" \
  --data '{"country":"US","number_type":"Local"}' \
  "https://api.multitel.net/v3/get_requirements"

Παράμετροι σώματος αιτήματος
Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
`country`	συμβολοσειρά	Ναι	Κωδικός ISO χώρας από το get_document_countries.
`number_type`	συμβολοσειρά	Ναι	Όνομα τύπου από το get_document_number_types, όπως Local· κατά την αντιστοίχιση δεν γίνεται διάκριση πεζών και κεφαλαίων. Δώστε το όνομα, όχι το αναγνωριστικό του.

Απόκριση

Ελέγξτε το status.code στο σώμα JSON, καθώς και την κατάσταση HTTP. Το response είναι ένας μεμονωμένος πόρος απαιτήσεων με id, type και attributes, καθώς και relationships όταν επιστρέφεται. Τα αναγνωριστικά στον πόρο και στα δεδομένα των σχέσεων είναι αδιαφανή. Από το προαιρετικό κείμενο του restriction_message αφαιρούνται οι ετικέτες HTML· χειριστείτε το υπόλοιπο περιεχόμενο ως κείμενο και όχι ως έμπιστο HTML. Ο χειριστής επιστρέφει τον πρώτο πόρο απαιτήσεων, επομένως μην συμπεραίνετε ότι αυτή η απόκριση αποτελεί εξαντλητική λίστα. Η διαθεσιμότητα γνωρισμάτων και σχέσεων εξαρτάται από τη χώρα και τον τύπο· το παράδειγμα δεν αποτελεί πλήρες και σταθερό σχήμα.

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "id": "REQUIREMENT_ID_FROM_RESPONSE",
    "type": "RESOURCE_TYPE_FROM_RESPONSE",
    "attributes": {
      "restriction_message": "Example country-specific instructions."
    }
  }
}

Σφάλματα

400: Η επικύρωση της χώρας και του number_type απέτυχε: δώστε και τις δύο υποχρεωτικές τιμές. Το κείμενο επικύρωσης ενδέχεται να περιέχει μορφοποίηση.
400: Invalid country ISO or No country registration documents required.: αυτό το αμφίσημο μήνυμα δεν αποδεικνύει από μόνο του απαλλαγή από την καταχώριση.
400: Invalid number type: χρησιμοποιήστε ένα όνομα τύπου που επιστρέφεται. Το σφάλμα της παλαιότερης έκδοσης παραθέτει τα Global, Local, Mobile, National, Shared Cost και Toll Free.
500: Unable to load registration requirements for the specified country and number type.: οι απαιτήσεις δεν επιστράφηκαν επιτυχώς. Δοκιμάστε ξανά αργότερα ή επικοινωνήστε με την υποστήριξη.

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

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