Тази крайна точка в стар формат връща тяло {"code", "data"} вместо стандартната обвивка status/response. Изброява видимите държави, свързани с каталога със специални номера, и не проверява наличността на номерата.
За нови интеграции:
- Използвайте
GET /v3/getcountries, за да намерите държави с налични номера. - Използвайте
GET /v3/other/{isocode}, за да видите кои видове специални номера действително се предлагат в дадена държава. За държава, посочена тук, тази крайна точка все пак може да върне празен каталог.
Заявка
Изисква се: удостоверяване чрез HTTP Basic или Bearer токен (вижте Удостоверяване и отговори на API). При неуспешно удостоверяване се връща HTTP 401 в стандартната обвивка, преди да се извърши справката.
GET без параметри и без тяло.
curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'Отговор
Тяло в стар формат без стандартната обвивка: {code: 200, data: [...]}. Няма обект status или полета msg и results. data съдържа списък на държавите без гарантиран ред. Полета: countrycode (телефонен код без '+'), name, description (същата стойност като name), isocode, latitude и longitude. Няма полета is_mobile, sms_coverage или next_function. Държава се включва в списъка, когато е видима и е свързана с каталога със специални номера. Наличността на номерата не се проверява, така че посочена държава може в момента да няма налични номера. Ако никоя държава не отговаря на условията, data има стойност null.
Примерна структура на отговора; не представлява данни от акаунта в реално време или актуална ценова оферта.
{
"code": 200,
"data": [
{
"countrycode": "33",
"name": "France",
"description": "France",
"isocode": "FR",
"latitude": "46.0000",
"longitude": "2.0000"
}
]
}Грешки
- 401: Удостоверяването липсва или е неуспешно. Изпраща се с HTTP status 401 в стандартната обвивка status/response, а не в тялото в стар формат.
Наличност и странични ефекти
- Само за справка. Не резервира, не поръчва и не променя нищо.