Skip to content

get_fares

Dmitry Balabanov edited this page Nov 15, 2024 · 7 revisions

Тарифы

Если вы хотите единожды узнать тарифы, вы можете это сделать на сайте или в репозитории открытых данных

Получить тарифы (стоимость и способы оплаты) проезда на трамвае.

GET https://kolomna-trams.ru/api/get_fares?
    key={API-ключ}
  & date={дата}
  & payment_type={способ оплаты}
  & passenger_type={тип пассажиров}
  & pricing_only={true/false}

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

Параметр Описание
key Ваш API-ключ
Параметр может быть опущен
date Дата
Дата, на которую необходимо получить тарифы, в формате ДД.ММ.ГГГГ
Если параметр опущен, будут показаны актуальные тарифы
payment_type Способ оплаты
Если параметр опущен, возвращаются тарифы для всех способов оплаты
Доступные способы: bank_card strelka_card troika_card student_strelka_card yellow_strelka_card e_card cash
passenger_type Тип пассажиров
Если параметр опущен, возвращаются тарифы для всех типов пассажиров
Доступные типы: all student schoolchild military_pensioners pensioners child_upto7
pricing_only Только тарификация
По умолчанию false. Если задано true, вывод будет содержать только информацию о тарифах (без внешней "обертки"), что позволит упростить ваш код (пример см. ниже). Метод сработает корректно только в том случае, когда для заданных параметров есть только один способ оплаты, поэтому должны быть указаны параметры payment_type и/или passenger_type

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

GET https://kolomna-trams.ru/api/get_fares?key=my_key&date=06.03.2022&payment_type=bank_card
// Получить тарифы оплаты банковской картой на 6 марта 2022 г.

Ответ

Успешный ответ возвращает JSON-объект со следующей структурой:

При pricing_only = false:

{
  "ok": "true",
  "result":
    {
      "effective_from": "12.05.2021",
      "effective_to": "28.11.2022",
      "tariffs":
        [
          {
            "type": "bank_card",
            "passengers": "all",
            "pricing":
              {
                "type": "fixed",
                "amount": 54
              }
          },
          // другие тарифы
        ]
    }
}

При pricing_only = true:

{
  "ok": "true",
  "result":
    {
      "type": "fixed",
      "amount": 54
    }
}

Clone this wiki locally