Popis prefiksa za područje

Prije početka

Odaberite područje putem getareas. Kopirajte ID područja iz odgovora ili vraćenog polja next_function. Za područje u SAD-u ili Kanadi upotrijebite getstates ako želite suziti rezultate na jednu saveznu državu ili pokrajinu.

Tumačenje rezultata

Provjerite status.code u tijelu JSON odgovora, kao i HTTP status. Uspješni rezultati nalaze se u polju response koje je niz. Zadani odgovor razvrstan je po nazivu. available je procjena, a oznake u katalogu ne zamjenjuju provjeru stvarnih mogućnosti odabranog broja i zahtjeva za registraciju.

Odaberite sljedeći korak

Upotrijebite negrupirani rezultat. Kada je vrijednost polja returns_numbers jednaka 1, vraćeno polje next_function upućuje na pretraživanje brojeva. Kada je vrijednost 0, brojevi se dodjeljuju pri naručivanju, a putanja upućuje na operaciju naručivanja. Prije slanja zahtjeva provjerite operaciju i njezine zahtjeve: zahtjev za naručivanje može teretiti vaš račun. Nemojte automatski slati zahtjeve na sve vraćene putanje.

Ovdje cijena nije uključena. Prije kupnje pregledajte odgovarajuću ponudu, potrebne dokumente i upute za naručivanje. Sačuvajte vraćene ID-ove pojedinačnih prefiksa i ponuda umjesto da ih sami sastavljate iz prikazanog telefonskog prefiksa.

Napredne mogućnosti prikaza

compact=1 vraća nasumično poredan uzorak od najviše 100 redaka, a ne stranicu većeg skupa rezultata. Grupiranje stvara sažete retke i sintetičke ID-ove; za odabir pojedinačnog prefiksa upotrijebite uobičajeni negrupirani odgovor. Nemojte na temelju uzorkovanih ili grupiranih rezultata tvrditi da prikazuju cjelokupnu ponudu ili točne mogućnosti.

Zahtjev

Upotrijebite vjerodajnice svojeg omogućenog API računa putem HTTPS-a. Podržani su autentifikacija Basic i omogućeni tokeni vrste bearer za API račun; primjenjuju se ograničenja računa.

Upotrijebite GET i pošaljite neobavezne parametre u nizu upita. Nemojte se oslanjati na zamjensko čitanje parametara iz tijela obrasca.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getprefixes/$AREA_ID?state=NY"

Odgovor

Standardna JSON omotnica status/response. Polje status.results broji vraćene retke, uključujući rezultate uzorkovanja ili grupiranja. Polje response sadrži objekte prefiksa. Polja s cijenama ne vraćaju se. U uobičajenom negrupiranom odgovoru uuid je ID prefiksa; area_uuid i country_uuid vraćeni su identifikatori; prefix i name podaci su za prikaz; available je procjena dostupnosti, a ne rezervacija; needs_registration i restrictions opisuju podatke o registraciji; sms_coverage, is_mobile i number_type naznake su iz kataloga, a ne jamstvo određene mogućnosti broja. Polje number_type može biti prazno ili sadržavati drugi niz znakova iz kataloga, stoga nemojte zahtijevati fiksni skup dopuštenih vrijednosti. Polje state niz je znakova i može biti prazno ili sadržavati oblikovanje iz kataloga. Polja latitude i longitude mogu biti prazna. Polja metered i overflow oznake su iz kataloga, a ne novčani iznosi. Polje returns_numbers odabire putanju za dohvat popisa brojeva (1) ili putanju za dodjelu broja pri naručivanju (0). Polje next_function identificira tu sljedeću putanju. Grupirani odgovori dodatno sadrže objedinjene značajke, uključujući zamjenske vrijednosti značajki; nemojte ih tumačiti kao provjerene mogućnosti svakog broja.

Ogledna struktura odgovora; ne predstavlja podatke računa uživo ni aktualnu ponudu.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "uuid": "PREFIX_ID_FROM_RESPONSE",
      "area_uuid": "AREA_ID_FROM_RESPONSE",
      "country_uuid": "COUNTRY_ID_FROM_RESPONSE",
      "prefix": "+1212",
      "name": "Example area",
      "metered": 0,
      "overflow": 0,
      "needs_registration": 0,
      "restrictions": "",
      "state": "NY",
      "country_iso": "US",
      "is_mobile": 0,
      "number_type": "local",
      "latitude": "",
      "longitude": "",
      "available": 12,
      "sms_coverage": 1,
      "returns_numbers": 1,
      "next_function": "v3/getnumbers/PREFIX_ID_FROM_RESPONSE"
    }
  ]
}

Pogreške

• 404: Invalid area ID: dohvatite aktualni ID područja pregledom ponude.
• 404: State filter is only available for US and CA: za ostale države izostavite state.
• 404: Invalid state: upotrijebite saveznu državu ili pokrajinu koju za ovu državu vraća getstates.
• 404: No prefixes found: nisu vraćeni odgovarajući retci iz kataloga. To ne dokazuje da se određeni broj nikada ne može naručiti.
• 500: Pogreška: 'Failed loading prefixes': pretraživanje kataloga nije uspjelo. Pokušajte ponovno kasnije i obratite se podršci ako se pogreška nastavi pojavljivati.

Dostupnost i popratni učinci

• Ovo je korak pregleda ponude, a ne potvrda narudžbe. Dostupnost se može osvježavati dodatnim pretraživanjima kataloga, pa vrijeme odziva može varirati.
• Cijene se ne vraćaju. Prije slanja narudžbe dohvatite odgovarajuću ponudu za broj ili narudžbu i pregledajte zahtjeve za registraciju.
• Nemojte tumačiti available kao točan broj raspoloživih brojeva, nulu kao opću zabranu naručivanja ni uspješno pretraživanje kao rezervaciju. Dostupnost se može promijeniti prije naručivanja.