Popis brojeva u projektu prijenosa

Pristup računu i projektu

Koristite omogućen API račun preko HTTPS s dopuštene IP adrese. Projekt mora pripadati tom računu i ne smije biti izbrisan. Koristite jedinstveni identifikator projekta iz tijeka naručivanja prijenosa brojeva, a ne njegov brojčani identifikator u bazi podataka ili telefonski broj. Pri sastavljanju zahtjeva primijenite URL kodiranje na identifikator projekta.

Zahtjev

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

Odgovor

Izmišljeni primjer odgovora.

{
  "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 je popis. Postojeći projekt bez brojeva vraća prazan popis s kodom API 200 i vrijednošću polja status.results jednakom 0. Nepostojeći projekti pak vraćaju kod API 404.

Polja brojeva

Polja brojeva za prijenos
Polje	Značenje
id, number, isocode	Brojčani identifikator retka, pohranjeni tekst telefonskog broja i oznaka države. Identifikator retka nije identifikator projekta.
status, status_str	Brojčani status i njegova poznata oznaka.
foc	Pohranjena vrijednost rasporeda za obvezujuću potvrdu narudžbe. Može biti prazna; obrađivač je ne pretvara u dokumentiranu vremensku zonu ili format vremenske oznake.
updated, date_created, date_completed	Pohranjene vrijednosti ažuriranja, stvaranja i dovršetka. Izričito obradite prazne vrijednosti; ne pretpostavljajte format ISO8601 i ne zaključujte vremensku zonu iz izmišljenog primjera.
comment	Pohranjeni komentar namijenjen korisniku. Prikažite ga kao tekst, a ne kao izvršivi HTML.

Ovaj prikaz izostavlja polje internal_comment namijenjeno samo zaposlenicima. To ne znači da zasebno starije pretraživanje jednog broja koristi isti prikaz.

Redoslijed i praćenje

Upit razvrstava rezultate uzlazno prema vremenu stvaranja. Za retke s istim vremenom stvaranja nije zajamčen dodatni redoslijed. Nema straničenja, inkrementalnog pokazivača ni filtra datuma. Pročitajte cijeli popis da biste uskladili podatke projekta i ne smatrajte njegov trenutačni broj redaka trajnim katalogom.

Tumačenje statusa prijenosa

Poznate vrijednosti statusa brojeva
Vrijednost	Oznaka
0	Pending
1	In Progress
2	Completed
9	Rejected

Zadržite brojčani status i obradite nepoznate vrijednosti. Za nepoznate oznake koristi se pohranjena vrijednost, bez jamstva nove oznake. Pohranjeni status dovršetka ili planirani datum sami po sebi ne provjeravaju usmjeravanje dolaznih poziva ili sve usluge broja.

Pogreške i ograničenja

Provjerite i HTTP odgovor i status.code/status.msg. Nepostojeći, izbrisani ili računu nepripadajući projekt vraća kod API 404 s porukom da projekt nije pronađen. Vrijede i ograničenja autentifikacije i izvorne IP adrese. Primjeri ne izvršavaju stvaran zahtjev, a uspješan odgovor ne dokazuje da je operator prihvatio ili dovršio prijenos.

Učinci

Pregledani obrađivač samo čita projekt i njegove pohranjene retke brojeva. Odgovor je snimka stanja, a ne potvrda operatora ili stvaran test usluge. Ne pokreće prijenos, ne mijenja usmjeravanje i ne tereti račun.