GET /api/external/v2/sc/{sc_id}/weather BASIC
Параметры#
| Имя | Тип | Обяз. | Описание |
|---|---|---|---|
sc_id | string, в пути | да | Идентификатор центра |
start_date | date | да | YYYY-MM-DD |
end_date | date | да | YYYY-MM-DD, не раньше start_date |
Погода берётся по городу, к которому привязан центр. Окно периода такое же, как у остальных подневных данных: на Basic 31 день и данные до вчера, на PRO 366 дней и сегодня. Пагинации нет.
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'Ответ#
Строки отсортированы по дате по возрастанию.
| Поле | Тип | Описание |
|---|---|---|
date | string | YYYY-MM-DD |
temp | number | Температура, °C |
wind_speed | number | Скорость ветра, м/с |
condition_id | integer | Код погодных условий по классификации OpenWeather |
condition_description | string | Описание погоды по-русски |
В meta.city приходит город, по которому взята погода: { id, name }.
{
"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_configured | 404 | У центра не задан город. Повторять бесполезно |
period_too_long | 422 | Период больше тарифного окна |
fresh_data_requires_pro | 422 | На Basic запрошен сегодняшний день |
validation_error | 422 | Нет дат, end_date раньше start_date, неразобранная дата |