Accesso all'account e al progetto
Utilizzare un account API abilitato tramite HTTPS da un indirizzo IP consentito. Il progetto deve appartenere a tale account e non deve essere stato eliminato. Utilizzare l'identificativo univoco del progetto ottenuto dal flusso di ordinazione della portabilità, non il suo identificativo numerico nel database né un numero di telefono. Applicare la codifica URL all'identificativo del progetto quando si costruisce una richiesta.
Richiesta
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Risposta
Esempio fittizio di risposta.
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}Un progetto esistente senza eventi restituisce il codice API 200, un elenco vuoto e status.results uguale a 0. I risultati vengono richiesti in ordine decrescente di data e ora di creazione, senza ulteriori criteri di ordinamento a parità di data e ora, paginazione, cursore o filtro per data.
Leggere attentamente i dati dell'evento
id è l'identificativo numerico della riga dell'evento, subject è l'oggetto memorizzato dell'evento e date_created è il valore memorizzato di data e ora. L'endpoint conserva in forma grezza la stringa event e tenta anche di decodificarne le proprietà type, value e source. Se i dati non costituiscono un oggetto JSON o manca una proprietà, il corrispondente campo ottenuto dall'analisi è una stringa vuota.
I dati non costituiscono un insieme fisso di valori enumerati né uno schema garantito di testo semplice. Non considerare il testo della fonte come un'identità verificata e non visualizzare il contenuto degli eventi come HTML. Mantenere gli eventi grezzi all'interno di flussi autorizzati sul lato server e mostrare agli utenti autorizzati solo il testo appropriato. Questo endpoint non dispone di un filtro separato di visibilità degli eventi per personale e clienti né di un meccanismo di oscuramento dei contenuti.
La cronologia non garantisce la consegna
Si tratta della cronologia memorizzata del progetto, non di un flusso di webhook, di un cursore di sincronizzazione immutabile o di un registro completo di tutte le modifiche al database. Ad esempio, l'aggiunta di numeri tramite il gestore di aggiunta dei numeri sottoposto a revisione non crea di per sé un evento. Oltre a leggere gli eventi, verificare la coerenza dell'elenco dei numeri e dei conteggi per stato.
Errori e limiti
Controllare 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 l'autenticazione e le restrizioni sull'indirizzo IP di origine. Gli esempi non effettuano richieste effettive e una risposta con esito positivo non dimostra che un operatore abbia accettato o completato un trasferimento.
Effetti
Il gestore sottoposto a revisione legge gli eventi memorizzati e non modifica il progetto, non avvia un trasferimento e non addebita importi all'account. La visibilità dei componenti che scrivono gli eventi e i test dell'account con autenticazione restano parte della revisione ancora da completare del contratto dell'API.