Documentazione dell’API REST

API REST per le chiamate di emergenza

Registra un numero e un indirizzo di servizio, segui lo stato di attivazione e mantieni aggiornato il record quando cambia la posizione.

Apri il riferimento specifico dell’account Sviluppatori e Automazione

Scegli insieme l’API e la credenziale

Gli account approvati per Sviluppatori e Automazione, Aziende e Fornitori di comunicazioni possono integrare i servizi abilitati. Uno sviluppatore individuale non deve fingere di essere un’azienda. Gli SMS/MMS delle applicazioni richiedono l’approvazione all’invio e la registrazione previste. Il servizio per Privati e famiglie non offre un’API di invio dei messaggi accessibile ai clienti.

Famiglia di API	URL di base	Autenticazione e risultato
Comunicazioni v3	`https://api.multitel.net/v3`	Credenziali Basic approvate; token predisposti idonei solo per le operazioni che li supportano. JSON `status` e `response`.
Registrazione per le emergenze	`https://api.multi.tel/emergency`	Credenziali Basic approvate oppure accesso bearer predisposto in modo specifico. JSON `code`, `message` e `data`.
Integrazioni REST del portale	Host e operazione indicati nel riferimento per sviluppatori del tuo account	Usa la credenziale, gli ambiti e lo schema documentati per quell’operazione. Le richieste di sessione del browser costituiscono una superficie separata.

Imposta MULTITEL_API_USERNAME e MULTITEL_API_PASSWORD tramite la configurazione dei segreti del tuo server prima di usare gli esempi. Non inserirli mai nel JavaScript pubblico del browser, negli URL o nel controllo del codice sorgente. Le credenziali dedicate si gestiscono nelle impostazioni di integrazione API.

Leggere la copertura senza registrare un numero

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

È supportato anche https://api.multitel.net/emergency. Nessuno dei due URL di base per le emergenze contiene /v3. La copertura elenca i paesi internazionali, i tipi di numero supportati e i prezzi; l’idoneità E911 nordamericana viene verificata durante la registrazione.

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

Questo esempio mostra solo la struttura esterna. Leggi lo schema data di ogni operazione nella guida pubblicata dell’API per le emergenze.

Registrare, seguire lo stato, poi configurare le chiamate

Per Stati Uniti/Canada e le altre regioni E911 nordamericane supportate, fornisci il numero, l’indirizzo E911 e le conferme di consenso richieste. L’E911 nordamericano è solo in produzione.
Per un numero internazionale supportato e di tua proprietà, fornisci un riferimento a un Document salvato oppure l’identità e l’indirizzo dell’utente finale. Controlla prima i requisiti del paese e del tipo di numero.
Invia una sola richiesta POST /registrations. Un Idempotency-Key facoltativo identifica una modifica logica; conservalo insieme al payload esatto in tutti i nuovi tentativi.
Leggi GET /registrations/:number. Controlla il ciclo di vita, pending e actionRequired; risolvi le correzioni richieste. L’accettazione o lo stato in sospeso non equivalgono a un servizio attivo.
Dopo l’attivazione, configura l’ID chiamante di emergenza corretto e il percorso di composizione specifico del paese. Usa la procedura di verifica non di emergenza del servizio.

Le registrazioni internazionali in sandbox sono isolate e non attivano chiamate di emergenza reali. Per l’E911 nordamericano sono necessarie le credenziali dell’account principale; la guida spiega il supporto limitato dei subaccount internazionali.

Configurazione e verifica dal portale Copertura per paese e numeri di emergenza Guida pubblica completa a richieste, campi, stato e nuovi tentativi

Gestire errori e nuovi tentativi

Errore di autenticazione o di autorizzazione: Verifica lo stato di abilitazione della credenziale API, il servizio consentito e la restrizione sull’IP di origine. Il cookie di sessione del portale non è una credenziale di integrazione.
Credito insufficiente o approvazione mancante: Risolvi il problema del saldo dell’account, dell’approvazione all’invio o del requisito documentale prima di ripetere l’operazione.
Nessun risultato: Gestisci un inventario vuoto o un nome del chiamante mancante come un esito ordinario. Non dare per scontato che un numero sintatticamente valido disponga di tutti i servizi.
Timeout di rete o guasto del servizio: Per le letture usa tentativi limitati con backoff. Per un acquisto, un invio o una registrazione, controlla prima lo stato dell’operazione: ripetere una richiesta già accettata può duplicare un’azione a pagamento.

Il supporto all’idempotenza dipende da ciascuna famiglia di API. L’API per le emergenze supporta chiavi di ripetizione; questo non rende idempotenti richieste v3 arbitrarie. Conserva marcature temporali, ID restituiti e risposte oscurate per l’assistenza.

Continua con il riferimento del tuo account

Il riferimento dopo l’accesso filtra le operazioni in base alle tue autorizzazioni e ai servizi abilitati. Usa l’host esatto, il tipo di credenziale, i campi della richiesta e lo schema della risposta che indica. Le console possono eseguire operazioni reali, inclusi acquisti e messaggi.

Catalogo degli endpoint specifico dell’account Console REST per le comunicazioni Documento OpenAPI pubblico per le comunicazioni Guida all’integrazione OAuth