Načtení událostí projektu přenosu čísel

Přístup k účtu a projektu

Použijte aktivovaný účet API přes HTTPS z povolené IP adresy. Projekt musí patřit tomuto účtu a nesmí být smazán. Použijte jedinečné ID projektu z pracovního postupu objednávky přenosu čísel, nikoli jeho číselné databázové ID ani telefonní číslo. Při sestavování požadavku zakódujte ID projektu pro použití v URL.

Požadavek

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"

Odpověď

Smyšlený příklad odpovědi.

{
  "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"
    }
  ]
}

Existující projekt bez událostí vrací kód API 200, prázdný seznam a hodnotu status.results rovnou 0. Výsledky jsou vyžádány v sestupném pořadí podle času vytvoření, bez dalšího řazení při shodě časů, stránkování, kurzoru nebo filtru podle data.

Data události čtěte pozorně

id je číselné ID řádku události, subject je její uložený předmět a date_created je její uložená hodnota data a času. Koncový bod zachovává původní hodnotu event jako řetězec a také se pokouší dekódovat její vlastnosti type, value a source. Pokud data nejsou objektem JSON nebo některá vlastnost chybí, odpovídající pole získané parsováním obsahuje prázdný řetězec.

Data události nemají podobu pevně daného výčtu hodnot ani zaručeného schématu prostého textu. Nepovažujte text zdroje za ověřenou identitu a nevykreslujte obsah události jako HTML. Nezpracované události uchovávejte v serverových pracovních postupech s řízeným oprávněním a oprávněným uživatelům zobrazujte pouze vhodný text. Tento koncový bod nemá samostatný filtr viditelnosti událostí pro zaměstnance a zákazníky ani funkci začerňování obsahu.

Historie není zárukou doručení

Jde o uloženou historii projektu, nikoli o proud webhooků, neměnný synchronizační kurzor nebo úplný záznam všech změn v databázi. Například přidání čísel prostřednictvím zkontrolované obslužné funkce pro přidávání čísel samo o sobě nevytváří událost. Kromě čtení událostí také porovnávejte a slaďujte seznam čísel a počty podle stavů.

Chyby a omezení

Zkontrolujte jak odpověď HTTP, tak status.code/status.msg. Neexistující či smazaný projekt nebo projekt, který nepatří danému účtu, vrací kód API 404 se zprávou, že projekt nebyl nalezen. Platí také ověřování přístupu a omezení zdrojových IP adres. Příklady neodesílají skutečný požadavek a úspěšná odpověď není důkazem, že operátor přenos přijal nebo dokončil.

Účinky

Zkontrolovaná obslužná funkce čte uložené události a nemění projekt, nezahajuje přenos ani nestrhává peníze z účtu. Přehled o tom, které části systému zapisují události, a testování s ověřeným přístupem k účtu zůstávají součástí dosud nedokončené kontroly kontraktu rozhraní.