GET/countriesСправочники

Справочник стран и поиск

Справочник стран с локализованными названиями и ISO-кодами.

Пагинация через after_id: передавайте meta.next_after_id, пока meta.has_more не станет false.
Результаты упорядочены по ID, а не по релевантности. Сортируйте по названию в своём интерфейсе.
Пакетный запрос через ids[]=208&ids[]=1, до 100 ID.

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

querystring≤ 200 chars

Необязательный поиск по буквальному началу названия. Для стран поиск также идёт по названиям на местном языке, ISO-кодам и сохранённым переводам. Пустой текст отключает этот фильтр.

ids[]integer[]≥ 1 · ≤ 100 items

Пакетный запрос. Повторяйте ids[]=2001&ids[]=3001; строка через запятую не принимается. Неизвестные ID пропускаются. Пересекается с другими фильтрами.

per_pageinteger1–1,000 · default 100

Максимальное количество возвращаемых записей. Пустые, нецелые или выходящие за диапазон значения возвращают 422.

after_idinteger≥ 1

Исключающий курсор по ID. В первом запросе не передавайте; затем используйте meta.next_after_id с неизменными фильтрами. Это не номер страницы. Пустые или неположительные значения возвращают 422.

langstring

Локаль ответа. Переводы опций также ограничены языками аккаунта. Страница автоматически подставляет текущий язык.

Возвращает · Объекты Country в data, с meta.has_more и meta.next_after_id.

GET/countries

curl -g "https://api.lotarius.com/countries?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"

ПримерыЗаписано

{2 keys

"data": [3 items

0: {6 keys

"id": 1

"name": "Afghanistan"

"original_name": "Afghanistan"

"native": "افغانستان"

"iso": "AF"

"iso3": "AFG"

}

1: {6 keys

"id": 2

"name": "Aland Islands"

"original_name": "Aland Islands"

"native": "Åland"

"iso": "AX"

"iso3": "ALA"

}

2: {6 keys

"id": 3

"name": "Albania"

"original_name": "Albania"

"native": "Shqipëria"

"iso": "AL"

"iso3": "ALB"

}

]

"meta": {3 keys

}