Города

Доступ к городам предоставляется всем пользователям,у которых указано соответствующее разрешение в личном кабинете.
Для получения информации о городах предусмотрены следующие запросы:

List

Метод list позволяет получить список городов

Запрос:

{site_path}/{lang}/api/city/list

Список GET параметров:

filter	array	Позволяет фильтровать данные по всем доступным полям
fields	string	Позволяет выбрать из всех доступных только указанные поля
sort	string	Позволяет сортировать по возрастанию и по убыванию сущности по всем доступным полям
page	int	Позволяет передать порядковый номер страницы списка сущностей

Список всех доступных полей

id	int	ID города
name	string	Название города
countryID	int	ID страны
regionID	int	ID региона

Ответ

Ответ передается в формате JSON. Список полей ответа:

result	array	Список городов с учетом параметров запроса
_links	array	Список ссылок навигации. Может содержать элементы: self - содержит ссылку на текущую страницу списка first - содержит ссылку на первую страницу списка last - содержит ссылку на последнюю страницу списка prev - содержит ссылку на предыдущую страницу списка next - содержит ссылку на следующую страницу списка
_meta	array	Информация по навигации списка. Содержит элементы: totalCount - общееколичество доступных сущностей учитывая все выбранные параметры pageCount - порядковый номер сущности в полученном списке, с которого начинается текущая страница currentPage - порядковый номер текущей страницы perPage - количество сущностей отображаемых на одной странице

Пример запроса:


              {site_path}/{lang}/api/city/list?filter[id][in][]=1&filter[id][in][]=2&filter[id][in][]=3&sort=name

Пример ответа:

{
  "result": [
    {
      "id": 18918,
      "name": "Protaras",
      "countryID": 34,
      "regionID": 88
    },
    {
      "id": 32767,
      "name": "Qarc",
      "countryID": 28,
      "regionID": 59
    },
    {
      "id": 5819,
      "name": "Souni",
      "countryID": 34,
      "regionID": 1
    }
  ],
  "_links": {
    "self": {
      "href": "{site_path}/{lang}/api/city/list?filter%5Bid%5D%5Bin%5D%5B0%5D=5819&filter%5Bid%5D%5Bin%5D%5B1%5D=18918&filter%5Bid%5D%5Bin%5D%5B2%5D=32767&sort=name&page=1"
    }
  },
  "_meta": {
    "totalCount": 3,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 20
  }
}