Адрес службы: POST

http://api.alemtat.kz/web/{ext}/Catalog/getCitiesByCountry


Получаем все населенные пункты указанной страны

Информация о запросе

URI параметры

НаименованиеОписаниеТипДополнительная информация
ext

Формат данных. JSON или XML.

string

Нет описания

Параметры запроса

Параметры населенного пункта

НаименованиеОписаниеТипДополнительная информация
CountryLocalCode

Локальный код страны

string

Обязательный

Максимальная длина: 4

ApiKey

Выданный API-ключ

string

Обязательный

Используется для получения доступа к данным

Форматы запроса

application/json, text/json

Пример:
{
  "CountryLocalCode": "sample string 1"
}

application/xml, text/xml

Пример:
<ParamCitiesByCountry xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ALES.WebAPI.Models">
  <CountryLocalCode>sample string 1</CountryLocalCode>
</ParamCitiesByCountry>

Примеры кода

$.ajax({
    type: 'POST',
    url: 'http://api.alemtat.kz/web/json/catalog/getCitiesByCountry',
    dataType: 'json',
    data: { ApiKey: 'Выданный API-ключ', CountryLocalCode: '0001' }
	success: function (data) {
        console.log(data);
    },
    error: function(xhr, status) {
        console.log(xhr.status + ': ' + xhr.statusText);
    }
});
$kv = array();
$kv['CountryLocalCode'] = '0001';
$kv['ApiKey'] = 'Выданный API-ключ';
$postdata = http_build_query($kv);
$opts = array('http' =>
	array(
	    'method'  => 'POST',
	    'header'  => 'Content-type: application/x-www-form-urlencoded',
	    'content' => $postdata
	)
);
$context = stream_context_create($opts);
$result = file_get_contents('http://api.alemtat.kz/web/json/catalog/getCitiesByCountry', false, $context);
echo $result;

Информация об ответе

Описание ответа

Возвращает массив из населенных пунктов

НаименованиеОписаниеТипДополнительная информация
LocalCode

Локальный код населенного пункта

string

Нет описания

LocalityName

Наименование населенного пункта

string

Нет описания

CountryLocalCode

Локальный код страны

string

Нет описания

Country

Страна

string

Нет описания

RegionLocalCode

Локальный код региона

string

Нет описания

Region

Регион

string

Нет описания

ICode

Код ИАТА

string

Нет описания

LocalityTypeName

Тип населенного пункта

string

Нет описания

KATO

Классификатор административно-территориальных объектов

string

Нет описания

Форматы ответа

application/json, text/json

Пример:
[
  {
    "LocalCode": "sample string 1",
    "LocalityName": "sample string 2",
    "CountryLocalCode": "sample string 3",
    "Country": "sample string 4",
    "RegionLocalCode": "sample string 5",
    "Region": "sample string 6",
    "ICode": "sample string 7",
    "LocalityTypeName": "sample string 8",
    "KATO": "sample string 9"
  },
  {
    "LocalCode": "sample string 1",
    "LocalityName": "sample string 2",
    "CountryLocalCode": "sample string 3",
    "Country": "sample string 4",
    "RegionLocalCode": "sample string 5",
    "Region": "sample string 6",
    "ICode": "sample string 7",
    "LocalityTypeName": "sample string 8",
    "KATO": "sample string 9"
  }
]

application/xml, text/xml

Пример:
<ArrayOfLocalityAPI xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ALES.WebAPI.Models">
  <LocalityAPI>
    <Country>sample string 4</Country>
    <CountryLocalCode>sample string 3</CountryLocalCode>
    <ICode>sample string 7</ICode>
    <KATO>sample string 9</KATO>
    <LocalCode>sample string 1</LocalCode>
    <LocalityName>sample string 2</LocalityName>
    <LocalityTypeName>sample string 8</LocalityTypeName>
    <Region>sample string 6</Region>
    <RegionLocalCode>sample string 5</RegionLocalCode>
  </LocalityAPI>
  <LocalityAPI>
    <Country>sample string 4</Country>
    <CountryLocalCode>sample string 3</CountryLocalCode>
    <ICode>sample string 7</ICode>
    <KATO>sample string 9</KATO>
    <LocalCode>sample string 1</LocalCode>
    <LocalityName>sample string 2</LocalityName>
    <LocalityTypeName>sample string 8</LocalityTypeName>
    <Region>sample string 6</Region>
    <RegionLocalCode>sample string 5</RegionLocalCode>
  </LocalityAPI>
</ArrayOfLocalityAPI>