для разработчиков На сайт Rentu

Погода

Температура, ветер и описание погоды по дням. Нужно, чтобы объяснять провалы и всплески посещаемости и выручки.

GET /api/external/v2/sc/{sc_id}/weather   BASIC

Параметры#

ИмяТипОбяз.Описание
sc_idstring, в путидаИдентификатор центра
start_datedateдаYYYY-MM-DD
end_datedateдаYYYY-MM-DD, не раньше start_date

Погода берётся по городу, к которому привязан центр. Окно периода такое же, как у остальных подневных данных: на Basic 31 день и данные до вчера, на PRO 366 дней и сегодня. Пагинации нет.

bash
curl -G "https://api.rentu.ru/api/external/v2/sc/$SC/weather" \
  -d start_date=2026-07-01 \
  -d end_date=2026-07-31 \
  -H 'Authorization: Bearer YOUR_TOKEN'

Ответ#

Строки отсортированы по дате по возрастанию.

ПолеТипОписание
datestringYYYY-MM-DD
tempnumberТемпература, °C
wind_speednumberСкорость ветра, м/с
condition_idintegerКод погодных условий по классификации OpenWeather
condition_descriptionstringОписание погоды по-русски

В meta.city приходит город, по которому взята погода: { id, name }.

json
{
  "success": true,
  "data": [
    {
      "date": "2026-07-01",
      "temp": 24.3,
      "wind_speed": 3.1,
      "condition_id": 803,
      "condition_description": "облачно с прояснениями"
    },
    {
      "date": "2026-07-02",
      "temp": 18.7,
      "wind_speed": 5.4,
      "condition_id": 501,
      "condition_description": "дождь"
    }
  ],
  "meta": {
    "city": {
      "id": "6512a1f0b3c4d5e6f7a8b900",
      "name": "Москва"
    }
  }
}

Практика#

Значение это снимок, а не среднее за сутки. Погода фиксируется один раз, на 16:00 по местному времени города.

За сегодня строки обычно нет. Погода за день появляется только на следующий день, поэтому даже на PRO запрос с сегодняшней датой, как правило, вернёт строки до вчера.

Пропуски возможны. День, за который погоду получить не удалось, в ответ не попадает: строк может быть меньше, чем дней в периоде.

Группировать по condition_id, а не по тексту. Описание предназначено человеку и может меняться, код стабилен. Коды 2xx это гроза, 5xx дождь, 6xx снег, 800 ясно.

Ошибки#

КодHTTPКогда
city_not_configured404У центра не задан город. Повторять бесполезно
period_too_long422Период больше тарифного окна
fresh_data_requires_pro422На Basic запрошен сегодняшний день
validation_error422Нет дат, end_date раньше start_date, неразобранная дата