Ova naslijeđena krajnja točka vraća tijelo {"code", "data"} umjesto standardne ovojnice status/response. Navodi vidljive zemlje povezane s katalogom posebnih brojeva i ne provjerava zalihe.
Za nove integracije:
- Upotrijebite
GET /v3/getcountriesda biste pronašli zemlje s brojevima na zalihi. - Upotrijebite
GET /v3/other/{isocode}da biste vidjeli koje se vrste posebnih brojeva doista nude u određenoj zemlji. Zemlja navedena ovdje ondje ipak može vratiti prazan katalog.
Zahtjev
Obavezno: HTTP Basic ili Bearer token (pogledajte Autentifikacija i odgovori API-ja). Na neuspješnu autentifikaciju odgovara se s HTTP 401 u standardnoj ovojnici prije izvršavanja pretraživanja.
GET bez parametara i bez tijela.
curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'Odgovor
Tijelo u naslijeđenom formatu bez standardne ovojnice: {code: 200, data: [...]}. Nema objekta status ni polja msg ili results. data navodi zemlje bez zajamčenog redoslijeda. Polja: countrycode (pozivni broj zemlje bez '+'), name, description (ista vrijednost kao name), isocode, latitude i longitude. Nema polja is_mobile, sms_coverage ili next_function. Zemlja se navodi kada je vidljiva i povezana s katalogom posebnih brojeva. Zalihe se ne provjeravaju, pa navedena zemlja trenutačno možda nema dostupnih brojeva. Ako nijedna zemlja ne zadovoljava uvjete, data ima vrijednost null.
Ilustrativni oblik odgovora; ne predstavlja podatke računa u stvarnom vremenu ni trenutačnu cjenovnu ponudu.
{
"code": 200,
"data": [
{
"countrycode": "33",
"name": "France",
"description": "France",
"isocode": "FR",
"latitude": "46.0000",
"longitude": "2.0000"
}
]
}Pogreške
- 401: Autentifikacija nedostaje ili nije uspjela. Šalje se uz HTTP status 401 u standardnoj ovojnici status/response, a ne u tijelu u naslijeđenom formatu.
Dostupnost i popratni učinci
- Samo pretraživanje. Ništa ne rezervira, ne naručuje ni ne mijenja.