Accesso all’account e al progetto
Utilizza un account API abilitato tramite HTTPS da un indirizzo IP consentito. Il progetto deve appartenere a tale account e non deve essere eliminato. Utilizza l’identificativo univoco del progetto proveniente dal flusso degli ordini di portabilità, non il suo identificativo numerico nel database né un numero di telefono. Applica la codifica URL all’identificativo del progetto quando crei una richiesta.
Richiesta
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Risposta
Esempio fittizio di risposta.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response è un elenco. Un progetto esistente senza numeri restituisce un elenco vuoto con il codice API 200 e un valore di status.results pari a 0. I progetti inesistenti restituiscono invece il codice API 404.
Campi dei numeri
| Campo | Significato |
|---|---|
| id, number, isocode | Identificativo numerico della riga, testo memorizzato del numero di telefono e codice del paese. L’identificativo della riga non è quello del progetto. |
| status, status_str | Stato numerico e relativa etichetta nota. |
| foc | Valore di pianificazione memorizzato dell’impegno fermo relativo all’ordine. Può essere vuoto; il gestore non lo converte in un fuso orario né in un formato di data e ora documentati. |
| updated, date_created, date_completed | Valori memorizzati di aggiornamento, creazione e completamento. Gestisci esplicitamente i valori vuoti; non presumere il formato ISO8601 e non dedurre un fuso orario dall’esempio fittizio. |
| comment | Commento memorizzato destinato al cliente. Visualizzalo come testo, non come HTML eseguibile. |
Questa rappresentazione omette il campo internal_comment riservato al personale. Ciò non significa che la ricerca legacy separata di un singolo numero utilizzi la stessa rappresentazione.
Ordinamento e monitoraggio
La query ordina i risultati per data e ora di creazione crescenti. Per le righe con la stessa data e ora di creazione non è garantito alcun ulteriore ordinamento. Non sono disponibili paginazione, cursore incrementale o filtro per data. Leggi l’elenco completo per riconciliare i dati di un progetto e non considerare il suo attuale numero di righe come un catalogo permanente.
Interpretare lo stato della portabilità
| Valore | Etichetta |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Conserva lo stato numerico e gestisci i valori sconosciuti. Per le etichette sconosciute si usa il valore memorizzato, senza garantire una nuova etichetta. Uno stato di completamento memorizzato o una data pianificata non costituiscono, da soli, un test dell’instradamento in entrata né di tutti i servizi del numero.
Errori e limiti
Controlla sia la risposta HTTP sia status.code/status.msg. Un progetto inesistente, eliminato o non appartenente all’account restituisce il codice API 404 con un messaggio che indica che il progetto non è stato trovato. Si applicano anche le restrizioni di autenticazione e dell’IP di origine. Gli esempi non effettuano alcuna richiesta reale e una risposta riuscita non dimostra che un operatore abbia accettato o completato un trasferimento.
Effetti
Il gestore esaminato legge soltanto il progetto e le relative righe di numeri memorizzate. La risposta è un’istantanea, non una conferma dell’operatore né un test reale del servizio. Non avvia una portabilità, non modifica l’instradamento e non addebita l’account.