MultiTEL

Τεκμηρίωση REST API

REST API κλήσεων έκτακτης ανάγκης

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

Άνοιγμα αναφοράς συγκεκριμένης για τον λογαριασμόΠρογραμματιστές & Αυτοματισμός

Επιλέξτε το API και το διαπιστευτήριο μαζί

Οι εγκεκριμένοι λογαριασμοί για Προγραμματιστές & Αυτοματισμό, Επιχειρήσεις και Παρόχους επικοινωνιών μπορούν να ενσωματώσουν ενεργοποιημένες υπηρεσίες. Ένας μεμονωμένος προγραμματιστής δεν χρειάζεται να προσποιείται ότι είναι εταιρεία. Τα SMS/MMS εφαρμογών απαιτούν την αντίστοιχη έγκριση αποστολής και εγγραφή. Η υπηρεσία για Ιδιώτες & οικογένειες δεν παρέχει API έναρξης αποστολής μηνυμάτων προσβάσιμο στους πελάτες.

Οικογένεια APIΒασική διεύθυνση URLΈλεγχος ταυτότητας και αποτέλεσμα
Επικοινωνίες v3https://api.multitel.net/v3Εγκεκριμένα διαπιστευτήρια Basic· μόνο επιλέξιμα παρεχόμενα διακριτικά για λειτουργίες που τα υποστηρίζουν. JSON status και response.
Καταχώριση έκτακτης ανάγκηςhttps://api.multi.tel/emergencyΕγκεκριμένα διαπιστευτήρια Basic ή ειδικά παρεχόμενη πρόσβαση bearer. JSON code, message και data.
Ενοποιήσεις REST της πύληςΟ κεντρικός υπολογιστής και η λειτουργία εμφανίζονται στην αναφορά προγραμματιστή του λογαριασμού σαςΧρησιμοποιήστε το τεκμηριωμένο διαπιστευτήριο, τα πεδία εφαρμογής και το σχήμα αυτής της λειτουργίας. Τα αιτήματα συνεδρίας προγράμματος περιήγησης αποτελούν ξεχωριστή επιφάνεια.

Ορίστε τα MULTITEL_API_USERNAME και MULTITEL_API_PASSWORD μέσω της διαμόρφωσης μυστικών του διακομιστή σας πριν χρησιμοποιήσετε τα παραδείγματα. Μην τα ενσωματώνετε ποτέ σε δημόσια JavaScript προγράμματος περιήγησης, διευθύνσεις URL ή έλεγχο πηγαίου κώδικα. Τα ειδικά διαπιστευτήρια διαχειρίζονται στις ρυθμίσεις ενοποίησης API.

Διαβάστε την κάλυψη χωρίς καταχώριση αριθμού

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multi.tel/emergency/coverage?environment=production"

Υποστηρίζεται επίσης το https://api.multitel.net/emergency. Καμία από τις βασικές διευθύνσεις URL έκτακτης ανάγκης δεν περιέχει /v3. Η κάλυψη απαριθμεί διεθνείς χώρες, υποστηριζόμενους τύπους αριθμών και τιμές· η επιλεξιμότητα E911 Βόρειας Αμερικής ελέγχεται κατά την καταχώριση.

{
  "code": 200,
  "message": "",
  "environment": "production",
  "requestId": "EXAMPLE_REQUEST_ID",
  "data": {}
}

Αυτό δείχνει μόνο την εξωτερική δομή. Διαβάστε το σχήμα data κάθε λειτουργίας στον δημοσιευμένο οδηγό του API έκτακτης ανάγκης.

Καταχωρίστε, παρακολουθήστε την κατάσταση και κατόπιν διαμορφώστε τις κλήσεις

  1. Για τις ΗΠΑ/Καναδά και τις άλλες υποστηριζόμενες περιοχές E911 Βόρειας Αμερικής, δώστε τον αριθμό, τη διεύθυνση E911 και τις απαιτούμενες βεβαιώσεις συναίνεσης. Το E911 Βόρειας Αμερικής είναι διαθέσιμη μόνο σε πραγματική λειτουργία.
  2. Για υποστηριζόμενο διεθνή αριθμό που σας ανήκει, δώστε είτε μια αποθηκευμένη αναφορά Εγγράφου είτε την ταυτότητα και τη διεύθυνση του τελικού χρήστη. Ελέγξτε πρώτα τις απαιτήσεις χώρας και τύπου αριθμού.
  3. Στείλτε ένα αίτημα POST /registrations. Ένα προαιρετικό Idempotency-Key προσδιορίζει μια λογική τροποποίηση· διατηρήστε το και το ακριβές φορτίο στις επαναλήψεις.
  4. Διαβάστε το GET /registrations/:number. Ελέγξτε τον κύκλο ζωής, τα pending και actionRequired· επιλύστε τις απαιτούμενες διορθώσεις. Η αποδοχή ή η εκκρεμότητα δεν είναι ενεργή υπηρεσία.
  5. Μετά την ενεργοποίηση, διαμορφώστε τη σωστή αναγνώριση καλούντος έκτακτης ανάγκης και τη διαδρομή κλήσης συγκεκριμένης για τη χώρα. Χρησιμοποιήστε τη διαδικασία επαλήθευσης μη έκτακτης ανάγκης της υπηρεσίας.

Οι διεθνείς καταχωρίσεις sandbox είναι απομονωμένες και δεν ενεργοποιούν πραγματικές κλήσεις έκτακτης ανάγκης. Απαιτούνται διαπιστευτήρια κύριου λογαριασμού για το E911 Βόρειας Αμερικής· ο οδηγός εξηγεί την περιορισμένη υποστήριξη δευτερευόντων λογαριασμών διεθνώς.

Ρύθμιση και επαλήθευση πύληςΚάλυψη ανά χώρα και αριθμοί έκτακτης ανάγκηςΠλήρης δημόσιος οδηγός αιτημάτων, πεδίων, κατάστασης και επαναλήψεων

Διαχείριση σφαλμάτων και επαναλήψεων

Αποτυχία ελέγχου ταυτότητας ή δικαιωμάτων
Ελέγξτε την κατάσταση ενεργοποίησης του διαπιστευτηρίου API, την επιτρεπόμενη υπηρεσία και τον περιορισμό IP προέλευσης. Ένα cookie συνεδρίας πύλης δεν αποτελεί διαπιστευτήριο ενοποίησης.
Ανεπαρκές υπόλοιπο ή μη εκπληρωμένη έγκριση
Τακτοποιήστε το υπόλοιπο του λογαριασμού, την έγκριση αποστολής ή την απαίτηση εγγράφων πριν επαναλάβετε τη λειτουργία.
Χωρίς αποτέλεσμα
Διαχειριστείτε το κενό απόθεμα ή ένα όνομα καλούντος που λείπει ως συνηθισμένο αποτέλεσμα. Μην υποθέτετε ότι ένας συντακτικά έγκυρος αριθμός διαθέτει κάθε υπηρεσία.
Λήξη χρονικού ορίου δικτύου ή αποτυχία υπηρεσίας
Για αναγνώσεις, χρησιμοποιήστε περιορισμένο αριθμό επαναλήψεων με σταδιακά αυξανόμενη καθυστέρηση. Για αγορά, αποστολή ή εγγραφή, ελέγξτε πρώτα την κατάσταση της λειτουργίας· η επανάληψη ενός αποδεκτού αιτήματος μπορεί να διπλασιάσει μια χρεώσιμη ενέργεια.

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

Συνεχίστε με την αναφορά του λογαριασμού σας

Η αναφορά μετά τη σύνδεση φιλτράρει τις λειτουργίες ανάλογα με τα δικαιώματά σας και τις ενεργοποιημένες υπηρεσίες. Χρησιμοποιήστε ακριβώς τον κεντρικό υπολογιστή (host), τον τύπο διαπιστευτηρίων, τα πεδία αιτήματος και το σχήμα απόκρισης που εμφανίζονται εκεί. Οι κονσόλες μπορούν να εκτελέσουν πραγματικές λειτουργίες, συμπεριλαμβανομένων αγορών και μηνυμάτων.

Κατάλογος endpoints ειδικά για τον λογαριασμόΚονσόλα REST επικοινωνιώνΔημόσιο έγγραφο OpenAPI επικοινωνιώνΟδηγός ενσωμάτωσης OAuth