Piekļuve kontam un projektam
Izmantojiet iespējotu API kontu, savienojoties ar HTTPS no atļautas IP adreses. Projektam jābūt šī konta īpašumā, un tas nedrīkst būt dzēsts. Izmantojiet projekta unikālo identifikatoru no numuru pārnešanas pasūtījuma darbplūsmas, nevis tā skaitlisko datubāzes identifikatoru vai tālruņa numuru. Veidojot pieprasījumu, kodējiet projekta identifikatoru atbilstoši URL kodēšanas noteikumiem.
Pieprasījums
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Atbilde
Izdomāts atbildes piemērs.
{
"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"
}
]
}Esošam projektam bez notikumiem tiek atgriezts API kods 200, tukšs saraksts un status.results ar vērtību 0. Rezultāti tiek pieprasīti izveides laika dilstošā secībā, bez papildu kārtošanas vienādu laika vērtību gadījumā, dalījuma lapās, kursora vai datuma filtra.
Rūpīgi izlasiet notikuma datus
id ir notikuma rindas skaitliskais identifikators, subject ir tā saglabātais temats, un date_created ir tā saglabātā datuma un laika vērtība. Galapunkts saglabā neapstrādāto event virkni un arī mēģina dekodēt tās laukus type, value un source. Ja dati nav JSON objekts vai trūkst kādas īpašības, attiecīgais parsētais lauks ir tukša virkne.
Notikuma datiem nav fiksētas uzskaitījuma vērtību kopas vai garantētas vienkārša teksta shēmas. Neuzskatiet avota tekstu par pārbaudītu identitāti un neatveidojiet notikuma saturu kā HTML. Neapstrādātus notikumus glabājiet servera puses darbplūsmās ar atbilstošām piekļuves tiesībām un lietotājiem ar atbilstošām tiesībām rādiet tikai piemērotu tekstu. Šim galapunktam nav atsevišķa notikumu redzamības filtra darbiniekiem un klientiem vai satura aizklāšanas.
Vēsture negarantē piegādi
Šī ir saglabāta projekta vēsture, nevis tīmekļa aizķeru plūsma, nemainīgs sinhronizācijas kursors vai pilnīgs visu datubāzes izmaiņu ieraksts. Piemēram, numuru pievienošana ar pārskatīto numuru pievienošanas apstrādātāju pati par sevi nerada notikumu. Papildus notikumu lasīšanai salīdziniet un saskaņojiet arī numuru sarakstu un skaitu katrā statusā.
Kļūdas un ierobežojumi
Pārbaudiet gan HTTP atbildi, gan status.code/status.msg. Ja projekts neeksistē, ir dzēsts vai nepieder kontam, tiek atgriezts API kods 404 ar ziņojumu, ka projekts nav atrasts. Spēkā ir arī autentifikācijas prasības un avota IP adreses ierobežojumi. Piemēri neveic reālu pieprasījumu, un veiksmīga atbilde nepierāda, ka operators ir pieņēmis vai pabeidzis numuru pārnešanu.
Darbības ietekme
Pārskatītais apstrādātājs lasa saglabātos notikumus un nemaina projektu, nesāk numuru pārnešanu un nenoraksta līdzekļus no konta. Notikumus ierakstošo komponentu pārskatāmība un konta testēšana ar autentifikāciju joprojām ietilpst vēl nepabeigtajā saskarnes līguma pārskatīšanā.