3. Страны

Метод API для получения данных по странам:

https://experience.tripster.ru/api/partners/<partner_name>/countries/

По одной стране:

https://experience.tripster.ru/api/partners/<partner_name>/countries/<ID>

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

  • Фильтры

    • ?has_tours=true - только страны, где есть туры

    • name_ru фильтр по названию на русском, позволяет проверить, есть ли в нашей БД нужная страна

    • name_en фильтры по названию страны на английском

  • Стандартные параметры format и page_size, прочитайте про постраничную загрузку данных

Примеры запросов

Список всех стран:
https://experience.tripster.ru/api/partners/<partner_name>/countries/

 

Данные по конкретной стране. 
Параметр <ID>:
https://experience.tripster.ru/api/partners/<partner_name>/countries/238/

 

Список стран с фильтрацией по имени на русском языке.
Фильтр name_ru:
https://experience.tripster.ru/api/partners/<partner_name>/countries/?name_ru=Россия

 

Список стран с фильтрацией по имени на английском языке.
Фильтр name_en:
https://experience.tripster.ru/api/partners/<partner_name>/countries/?name_en=Russia

 

Примеры ответов

Список стран { "count": 93, "next": "https://experience.tripster.ru/api/partners/<partner_name>/countries/?page=2", "previous": null, "results": [ { "id": 238, "name_ru": "Россия", "name_en": "Russia", "currency": "RUB", "in_obj_phrase": "в России", "across_obj_phrase": "по России", "experience_count": 5415, "tours_count": 197, "url": "https://experience.tripster.ru/destinations/russia/", "region": "CIS" }, } Данные по одной стране { "count": 84, "next": "https://experience.tripster.ru/api/partner/partner_name/countries/?page=2", "previous": null, "results": [ { "id": 238, "name_ru": "Россия", "name_en": "Russia", "currency": "RUB", "in_obj_phrase": "по России", "across_obj_phrase": "по России", "experience_count": 5415, "tours_count": 197, "url": "https://experience.tripster.ru/destinations/russia/", "region": "CIS" } ] }

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

Параметр

Описание

Тип

id

ID страны в Трипстере

Число

name_ru

Название страны на русском

Строка

name_en

Название страны на английском

Строка

currency

Трехбуквенный код валюты страны. Цены на все экскурсии в стране будут в этой валюте. Мы используем RUB, EUR, GBP, USD. 

Строка

in_obj_phrase

Название страны с предлогом для фразы "Экскурсии в стране"

Строка

across_obj_phrase

Название страны с предлогом для фразы "Экскурсии по стране"

Строка

experience_count

Число экскурсий в стране

Число

tours_count

Число туров в стране

Число

url

Ссылка на страницу страны на Трипстере (прочитайте про правила формирования ссылок)

Строка

region

Регион мира:

EU - Европа

CIS - Россия и СНГ

AS - Азия

AM - Америка

AF - Африка

OC - Австралия

AN - Антарктида 

Строка