Konto- und Projektzugriff
Verwenden Sie ein aktiviertes API-Konto über HTTPS von einer zugelassenen IP-Adresse aus. Das Projekt muss zu diesem Konto gehören und darf nicht gelöscht sein. Verwenden Sie die eindeutige Projekt-ID aus dem Ablauf für Portierungsaufträge, nicht die numerische Datenbank-ID oder eine Telefonnummer. Kodieren Sie die Projekt-ID beim Erstellen einer Anfrage für die Verwendung in einer URL.
Anfrage
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Antwort
Fiktives Antwortbeispiel.
{
"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"
}
]
}Für ein vorhandenes Projekt ohne Ereignisse werden der API-Code 200, eine leere Liste und status.results mit dem Wert 0 zurückgegeben. Die Ergebnisse werden nach Erstellungszeitpunkt absteigend angefordert, ohne zusätzliche Sortierung bei gleichen Zeitpunkten, Seiteneinteilung, Cursor oder Datumsfilter.
Ereignisnutzdaten sorgfältig auswerten
id ist die numerische ID des Ereignisdatensatzes, subject ist dessen gespeicherter Betreff und date_created ist dessen gespeicherter Datums- und Zeitwert. Der Endpunkt behält die unverarbeitete Zeichenfolge in event bei und versucht außerdem, die darin enthaltenen Eigenschaften type, value und source zu dekodieren. Wenn die Nutzdaten kein JSON-Objekt sind oder eine Eigenschaft fehlt, enthält das entsprechende geparste Feld eine leere Zeichenfolge.
Die Nutzdaten entsprechen weder einer festen Aufzählung noch einem garantierten Klartextschema. Behandeln Sie den Text der Quellenangabe nicht als verifizierte Identität und stellen Sie Ereignisinhalte nicht als HTML dar. Belassen Sie unverarbeitete Ereignisse in autorisierten serverseitigen Abläufen und zeigen Sie autorisierten Benutzern nur geeignete Texte an. Dieser Endpunkt bietet weder einen gesonderten Filter für die Ereignissichtbarkeit für Mitarbeiter und Kunden noch eine Schwärzung von Inhalten.
Der Verlauf garantiert keine Zustellung
Dies ist der gespeicherte Projektverlauf, kein Webhook-Datenstrom, kein unveränderlicher Synchronisierungscursor und keine vollständige Aufzeichnung aller Datenbankänderungen. Beispielsweise erzeugt das Hinzufügen von Rufnummern über den geprüften Handler zum Hinzufügen von Rufnummern für sich genommen kein Ereignis. Gleichen Sie zusätzlich zum Abrufen der Ereignisse auch die Rufnummernliste und die Anzahlen je Status ab.
Fehler und Einschränkungen
Prüfen Sie sowohl die HTTP-Antwort als auch status.code/status.msg. Bei einem nicht vorhandenen, gelöschten oder nicht zum Konto gehörenden Projekt wird der API-Code 404 mit einer Meldung zurückgegeben, dass das Projekt nicht gefunden wurde. Die Anforderungen an die Authentifizierung und die Beschränkungen für Quell-IP-Adressen gelten ebenfalls. Die Beispiele führen keine tatsächliche Anfrage aus, und eine erfolgreiche Antwort ist kein Nachweis dafür, dass ein Netzbetreiber eine Portierung angenommen oder abgeschlossen hat.
Auswirkungen
Der geprüfte Handler liest gespeicherte Ereignisse und verändert weder das Projekt noch startet er eine Portierung oder belastet das Konto. Die Sichtbarkeit der ereignisschreibenden Komponenten und Tests mit authentifiziertem Kontozugriff bleiben Teil der noch ausstehenden Prüfung des Schnittstellenvertrags.