Pārbaudiet numuru pārnešanas projekta statusu

Piekļuve kontam un projektam

Izmantojiet iespējotu API kontu, veidojot savienojumu ar HTTPS no atļautas IP adreses. Projektam ir jāpieder šim kontam, 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 URL formātā.

Pieprasījums

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

Šis galapunkts nenolasa pieprasījuma saturu, lappušu dalījuma parametrus vai datuma filtru.

Atbilde

Izdomāts atbildes piemērs.

{
  "status": {
    "code": 200,
    "msg": "Project Status"
  },
  "response": {
    "uniqueid": "PROJECT_EXAMPLE",
    "status": 2,
    "status_str": "Completed",
    "counts": {
      "total": 2,
      "pending": 0,
      "in_progress": 0,
      "completed": 1,
      "rejected": 1
    }
  }
}

Ārējais lauks status.code norāda API rezultātu. Atsevišķais lauks response.status ir no projekta datiem atvasināts numuru pārnešanas kopsavilkums. Nejauciet šos divus laukus.

Kopsavilkums nav visu numuru kopējais rezultāts

Kopsavilkumā tiek izvēlēts In Progress, ja kaut vienam numuram ir šis statuss; pretējā gadījumā tiek izvēlēts Pending, tad Completed, tad Rejected. Ja nav neviena atbilstoša zināma statusa, pēc noklusējuma tiek izmantots Pending. Tāpēc projektam, kurā ir gan numuri ar pabeigtu pārnešanu, gan noraidīti numuri, tiek norādīts Completed, lai gan tajā joprojām ir noraidīti numuri.

Pirms secināt, ka viss projekts ir pabeigts, vienmēr pārbaudiet skaitu sadalījumu un atsevišķo numuru sarakstu. counts.total ietver katru projekta numura ierakstu; pārējie skaitītāji aptver tikai četras zināmās statusa vērtības, un to summa var nesakrist ar kopējo skaitu, ja ir arī citas vērtības. Projektam bez numuriem visi skaitītāji rāda nulli, un kopsavilkumā ir Pending.

Numuru pārnešanas statusa interpretācija

Saglabājiet skaitlisko statusu un nodrošiniet nezināmu vērtību apstrādi. Nezināmu apzīmējumu gadījumā tiek izmantota saglabātā vērtība; jauns apzīmējums netiek garantēts. Saglabāts pabeigšanas statuss vai ieplānotais datums pats par sevi nepārbauda ienākošo zvanu maršrutēšanu vai visus numura pakalpojumus.

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. Ir spēkā arī autentifikācijas 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 numura pārnešanu.

Darbības ietekme

Šis galapunkts nolasa saglabātos projekta skaitītājus. Pārskatītajā apstrādātājā tas neiesniedz numura pārnešanas pieprasījumu, nemaina statusu, neuzsāk zvanu un nenoraksta līdzekļus no konta. Tas nenodrošina operatora datu periodisku pieprasīšanu reāllaikā vai tīmekļa aizķeres abonementu.