Lys nommers in ’n nommeroordragprojek

Rekening- en projektoegang

Gebruik ’n geaktiveerde API-rekening oor HTTPS vanaf ’n toegelate IP-adres. Die projek moet aan daardie rekening behoort en mag nie uitgevee wees nie. Gebruik die projek se unieke ID uit die nommeroordragbestelproses, nie die numeriese databasis-ID of ’n telefoonnommer nie. URL-enkodeer die projek-ID wanneer jy ’n versoek opstel.

Versoek

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

Antwoord

Voorbeeld van ’n fiktiewe antwoord.

{
  "status": {
    "code": 200,
    "msg": "Project Numbers",
    "results": 1
  },
  "response": [
    {
      "id": 21,
      "number": "12025550123",
      "status": 0,
      "status_str": "Pending",
      "isocode": "US",
      "updated": "2026-10-23 12:00:00",
      "foc": "",
      "comment": "Example customer-visible note",
      "date_created": "2026-10-23 12:00:00",
      "date_completed": ""
    }
  ]
}

response is ’n lys. ’n Bestaande projek sonder nommers lewer ’n leë lys met API-kode 200 en status.results gelyk aan 0. Projekte wat nie bestaan nie, lewer daarenteen API-kode 404.

Nommer se velde

Velde vir nommers wat oorgedra word
Veld	Betekenis
id, number, isocode	Numeriese ry-ID, gestoorde telefoonnommerteks en landkode. Die ry-ID is nie die projek-ID nie.
status, status_str	Numeriese status en die bekende etiket daarvan.
foc	Gestoorde skeduleringswaarde vir die vaste bestelverbintenis. Dit kan leeg wees; die hanteerder skakel dit nie om na ’n gedokumenteerde tydsone of tydstempelformaat nie.
updated, date_created, date_completed	Gestoorde waardes vir opdatering, skepping en voltooiing. Hanteer leë waardes uitdruklik; moenie ISO8601 aanvaar of ’n tydsone uit die fiktiewe voorbeeld aflei nie.
comment	Gestoorde kliëntgerigte opmerking. Vertoon dit as teks, nie as uitvoerbare HTML nie.

Hierdie antwoordstruktuur laat die personeelveld internal_comment weg. Dit beteken nie dat die afsonderlike ouer opsoekfunksie vir ’n enkele nommer dieselfde antwoordstruktuur gebruik nie.

Volgorde en monitering

Die navraag rangskik volgens skeppingstyd in stygende volgorde. Rye met dieselfde skeppingstyd het geen verdere gewaarborgde volgorde nie. Daar is geen paginering, inkrementele wyser of datumfilter nie. Lees die volledige lys om ’n projek se data te versoen, en moenie die huidige rytelling as ’n permanente katalogus beskou nie.

Vertolk die nommeroordragstatus

Bekende nommerstatuswaardes
Waarde	Etiket
0	Pending
1	In Progress
2	Completed
9	Rejected

Behou die numeriese status en hanteer onbekende waardes. Vir onbekende etikette word die gestoorde waarde gebruik in plaas van ’n gewaarborgde nuwe etiket. ’n Gestoorde voltooiingstatus of geskeduleerde datum toets nie op sigself inkomende roetering of elke diens op die nommer nie.

Foute en beperkings

Gaan sowel die HTTP-antwoord as status.code/status.msg na. ’n Projek wat ontbreek, uitgevee is of nie aan die rekening behoort nie, lewer API-kode 404 met ’n boodskap dat die projek nie gevind is nie. Verifikasie- en bron-IP-beperkings geld ook. Die voorbeelde stuur nie ’n regstreekse versoek nie, en ’n suksesvolle antwoord bewys nie dat ’n netwerkoperateur ’n oordrag aanvaar of voltooi het nie.

Uitwerking

Die nagegane hanteerder lees slegs die projek en sy gestoorde nommerrye. Die antwoord is ’n momentopname, nie ’n operateurbevestiging of ’n regstreekse dienstoets nie. Dit begin nie ’n nommeroordrag nie, verander nie roetering nie en debiteer nie die rekening nie.