Dohvat podataka o jednom kupljenom broju

Dohvatite jedan zapis o kupljenom broju i njegovu pohranjenu konfiguraciju. Ova operacija vraća objekt umjesto polja koje vraća krajnja točka inventory.

Zahtjev

Upotrijebite vjerodajnice za API na strani poslužitelja putem HTTPS-a. Primjeri čitaju vjerodajnice iz varijabli okruženja; ne sadrže vjerodajnice koje se mogu upotrijebiti za pristup. Provjerite status.code u tijelu JSON odgovora, kao i HTTP status. Ovi naslijeđeni obrađivači ne postavljaju dosljedno HTTP status pogreške kada dođe do pogreške aplikacije.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

Obvezni segment putanje jest pohranjeni međunarodni telefonski broj, a ne njegov UUID ili interni broj telefonske centrale. Ovaj obrađivač ne upotrebljava parametre upita ni tijelo zahtjeva.

Odgovor

Ovo je ogledni primjer strukture odgovora, a ne podaci računa ili aktualna ponuda cijene.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

Vraćena polja s podacima o broju
Polje	Značenje
`number, uuid, description, isocode`	Pohranjeni telefonski broj, identifikator broja čiju unutarnju strukturu ne treba tumačiti, opis i oznaka države.
`config`	Pohranjena polja za odredišta govornih poziva, vanjsko prosljeđivanje, odredište SMS poruka i prosljeđivanje SMS poruka. Ova ih krajnja točka ne mijenja.
`features`	Pohranjene oznake podrške za govorne pozive, SMS i MMS. Nije zajamčeno da su naslijeđene pohranjene oznake logičke vrijednosti u JSON-u.
`status.capacity`	Vrijednosti dodijeljenih i iskorištenih kanala, postavka preljeva i pohranjena naknada za prekoračenje. To su pohranjeni metapodaci, a ne nova ponuda kapaciteta ili test poziva uživo.
`status.origination`	Pohranjeni metapodaci o izvorištu poziva. Identifikatore tretirajte kao vrijednosti čiju unutarnju strukturu ne treba tumačiti; nemojte izvoditi logiku aplikacije iz internih naziva.
`status.service_active, force_codec, force_dtmf`	Pohranjena polja za aktivaciju i konfiguraciju medija. Sama oznaka ne dokazuje uspješnu dolaznu isporuku.
`billing`	Pohranjene vrijednosti za CNAM, preljev, obnovu, trajnost i stvaranje. Njihovo čitanje ne mijenja obnovu ni druge postavke naplate.
`price`	Pohranjene cijene uspostave, mjesečne cijene, cijene po minuti i kvote minuta. Obrađivač ne pruža polje valute ni novu ponudu. Nemojte zaključivati o valuti na temelju oglednih vrijednosti niti ih upotrebljavati kao aktualnu ponudu za kupnju.

U usporedbi s inventory, ova krajnja točka vraća i needs_registration, vrating, country_id, area_id, provider_id i price.perminute_charges. To su naslijeđene pohranjene vrijednosti, a ne zaseban odgovor o odobrenju identiteta. Referentne identifikatore treba tretirati kao vrijednosti čiju unutarnju strukturu ne treba tumačiti; nemojte na temelju njih sastavljati URL-ove za otkrivanje podataka niti zaključivati o preslikavanjima pružatelja usluga bez odgovarajućeg odgovora za otkrivanje podataka.

Nema odgovarajućeg broja

Ako za autentificirani račun nije pronađen odgovarajući zapis koji nije poništen, tijelo JSON odgovora sadrži status.code 404 i poruku koja sadrži number not found. Nemojte se oslanjati na njezin sufiks s oznakom retka izvornog koda. Prije ponovnog pokušaja provjerite pohranjeni broj i inventory.

Upotreba rezultata

Ova operacija čita spremljene podatke. Njome se ne kupuje broj, ne odobravaju identifikacijski dokumenti, ne mijenja odredište niti jamči da će poziv, faks ili poruka biti isporučeni. Pri konfiguriranju broja zasebno testirajte svaku omogućenu uslugu.