Šis mantotais galapunkts atgriež {"code", "data"} saturu standarta status/response aploksnes vietā. Tas uzskaita redzamās valstis, kuras ir saistītas ar speciālo numuru katalogu, un nepārbauda numuru pieejamību.
Jaunām integrācijām:
- Izmantojiet
GET /v3/getcountries, lai atrastu valstis, kurās ir pieejami numuri. - Izmantojiet
GET /v3/other/{isocode}, lai noskaidrotu, kādi speciālo numuru veidi valstī faktiski tiek piedāvāti. Pat ja valsts ir norādīta šajā sarakstā, šis otrs galapunkts tai var atgriezt tukšu katalogu.
Pieprasījums
Nepieciešama HTTP Basic autentifikācija vai Bearer pilnvara (skatiet sadaļu «Autentifikācija un API atbildes»). Ja autentifikācija neizdodas, pirms uzmeklēšanas tiek atgriezta atbilde ar HTTP 401 standarta aploksnē.
GET bez parametriem un bez pieprasījuma satura.
curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'Atbilde
Mantotais atbildes saturs bez standarta aploksnes: {code: 200, data: [...]}. Nav objekta status un lauku msg vai results. data uzskaita valstis bez garantētas secības. Lauki: countrycode (valsts tālruņa kods bez '+'), name, description (tāda pati vērtība kā laukam name), isocode, latitude un longitude. Nav lauku is_mobile, sms_coverage vai next_function. Valsts tiek iekļauta sarakstā, ja tā ir redzama un saistīta ar speciālo numuru katalogu. Numuru pieejamība netiek pārbaudīta, tāpēc sarakstā norādītā valstī pašlaik var nebūt pieejams neviens numurs. Ja neviena valsts neatbilst nosacījumiem, data vērtība ir null.
Ilustratīva atbildes struktūra; tie nav aktuāli konta dati vai pašreizējais cenas piedāvājums.
{
"code": 200,
"data": [
{
"countrycode": "33",
"name": "France",
"description": "France",
"isocode": "FR",
"latitude": "46.0000",
"longitude": "2.0000"
}
]
}Kļūdas
- 401: Autentifikācija nav veikta vai nav izdevusies. Tiek nosūtīta atbilde ar HTTP status 401 standarta status/response aploksnē, nevis mantotajā atbildes saturā.
Pieejamība un blakusefekti
- Tikai uzmeklēšana. Nekas netiek rezervēts, pasūtīts vai mainīts.