TEST-API-GIS

Тестовое задание QAA по работе с API

Практика

Имеется API для выдачи регионов с одним методом: GET /1.0/reg — возвращает список регионов в формате:

{
      "total": 1, // Общее количество регионов в базе
      "items": [
      {
        "id": 1, // Уникальный идентификатор региона
        "region": "Казань", // Название региона
        "enregion": "Kazan", // Код региона
        "country": {
          "name": "Россия", // Название страны региона
          "code": "ru" // Код страны региона
      }
    }
  ]
}

Доступные query-параметры

Название	Описание	Пример
q	Произвольная строка для нечёткого поиска* по названию региона; Минимум — 3 символа; Регистр не имеет значения Если передан этот параметр, все остальные параметры игнорируются	GET /1.0/reg?q=Казань
country_code	Код страны для фильтрации; Может принимать значения: ru, kg, kz, cz; По умолчанию отображаются регионы из всех стран	GET /1.0/reg?country_code=ru
page	Порядковый номер страницы; Минимальное значение — 1; Значение по умолчанию — 1	GET /1.0/reg?page=2
page_size	Количество элементов на странице; Может принимать значения: 5, 10, 15; Значение по умолчанию — 15	GET /1.0/reg?page=3&page_size=5

• Нечёткий поиск — поиск по вхождению подстроки в строку. Например, если поискать «рск», в ответе должны отобразиться регионы: Новосибирск,Магнитогорск, Орск и.т.д.

• API доступно по адресу https://regions-test.com/1.0/regions.

• Для отображения JSON в браузере можно использовать расширение «JSON Formatter».

  Описание задачи и код немного отредактирован для обхода поиска решений.