CarStat.dev
Підключити ключ
GET/countriesДовідники

Довідник і пошук країн

Довідник країн з локалізованими назвами та кодами ISO.

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

Параметри запиту

5
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}
}