Listimi i vendeve të katalogut (format i vjetër)

Kjo pikë fundore e vjetër kthen një trup përgjigjeje të formës {"code", "data"} në vend të mbështjellësit standard status/response të përgjigjes. Liston vendet e dukshme të lidhura me katalogun e numrave të veçantë dhe nuk kontrollon gjendjen e numrave.

Për integrimet e reja:

• Përdorni GET /v3/getcountries për të gjetur vendet me numra në gjendje.
• Përdorni GET /v3/other/{isocode} për të parë cilat lloje numrash të veçantë ofrohen realisht në një vend. Edhe nëse një vend listohet këtu, ajo kërkesë mund të kthejë një katalog bosh për atë vend.

Kërkesa

Kërkohet: autentikim HTTP Basic ose token Bearer (shihni Autentikimi dhe përgjigjet e API-së). Nëse autentikimi dështon, kthehet HTTP 401 në mbështjellësin standard të përgjigjes përpara se të kryhet kërkimi.

GET pa parametra dhe pa trup kërkese.

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'

Përgjigjja

Trup përgjigjeje në formatin e vjetër, pa mbështjellësin standard: {code: 200, data: [...]}. Nuk ka objekt status dhe as fusha msg ose results. data liston vendet pa garantuar ndonjë renditje. Fushat: countrycode (prefiksi telefonik pa '+'), name, description (e njëjta vlerë si name), isocode, latitude dhe longitude. Nuk ka fusha is_mobile, sms_coverage ose next_function. Një vend listohet kur është i dukshëm dhe i lidhur me katalogun e numrave të veçantë. Gjendja e numrave nuk kontrollohet, prandaj një vend i listuar mund të mos ketë asnjë numër të disponueshëm për momentin. Nëse asnjë vend nuk i plotëson kushtet, data është null.

Shembull ilustrues i strukturës së përgjigjes; nuk përfaqëson të dhëna të llogarisë në kohë reale apo një ofertë çmimi aktuale.

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

Gabimet

• 401: Autentikimi mungon ose ka dështuar. Dërgohet me status HTTP 401 në mbështjellësin standard status/response të përgjigjes, jo në trupin e përgjigjes në formatin e vjetër.

Disponueshmëria dhe efektet anësore

• Vetëm kërkim. Nuk rezervon, nuk porosit dhe nuk ndryshon asgjë.