https://github.com/andcool-systems/weather-widget-api
Виджет погоды для вашего профиля GitHub
https://github.com/andcool-systems/weather-widget-api
api pillow pyowm python3 widget
Last synced: 3 months ago
JSON representation
Виджет погоды для вашего профиля GitHub
- Host: GitHub
- URL: https://github.com/andcool-systems/weather-widget-api
- Owner: Andcool-Systems
- License: mit
- Created: 2023-08-20T19:19:39.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-11T19:17:26.000Z (5 months ago)
- Last Synced: 2025-03-25T16:23:39.289Z (4 months ago)
- Topics: api, pillow, pyowm, python3, widget
- Language: Python
- Homepage: https://weather.andcool.ru
- Size: 33.7 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Weather Widget
Виджет погоды в виде изображения, который вы можете установить куда угодно, например, в readme своего профиля GitHub.
## Подробнее об API
API расположен на **GET** https://weather.andcool.ru/api
Все ответы, полученные с endpoint'а /api на домене weather.andcool.ru будут кэшироваться на 2 часа, вне зависимости от переданного cache-control хедера.
> Для упрощения создания виджета, можете использовать конструктор на [сайте](https://weather.andcool.ru)
### Параметры
| Название | Описание | По умолчанию | Возможные значения | Обязательный |
|----------|-----------------------------------------------|--------------|---------------------|--------------|
| place | Название населённого пункта на любом языке | - | Строка | Да |
| language | Язык, который будет использоваться в картинке | ru | Зависит от темы | Нет |
| theme | Используемая тема виджета | default | default, pixel-city | Нет |
Некоторые темы могут иметь свои обязательные или необязательные параметры.
Подробнее о них можно узнать в разделе [Темы](https://github.com/Andcool-Systems/weather-widget-api#темы).
### Ошибки API
| HTTP код | Возвращаемый code | Описание | Решение ошибки |
|----------|-------------------|--------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|
| 404 | place_not_found | Переданный населённый пункт не найден. | Передать корректное место. |
| 400 | lang_not_found | Переданный язык не найден. | Передать язык, который поддерживает [тема](https://github.com/Andcool-Systems/weather-widget-api#темы). |
| 400 | tz_not_found | Переданный часовой пояс не найден (только в теме default). | Передать корректный [код временной зоны](https://github.com/Andcool-Systems/weather-widget-api#параметры-тем). |
| 400 | theme_not_found | Переданная тема не найдена. | Указать [существующую тему](https://github.com/Andcool-Systems/weather-widget-api#темы). |
| 500 | internal_error | Внутренняя ошибка (может возникнуть по разным причинам). | Решения нету. Можете создать [Issue](https://github.com/Andcool-Systems/weather-widget-api/issues) с описанием проблемы. |
> Внутренние ошибки бывают двух видов: на уровне облачной функции, обрабатываемые в try-except и на уровне шлюза.
> Ошибки на уровне шлюза обычно являются более критичными, однако ошибки на уровне функции проще отследить, поэтому в Issue прикладывайте UUID код ошибки, если он присутствует.
## Темы
### default
**Тема по умолчанию.**
Содержит наибольшее количество информации о погоде. Подстроена под стандартную тёмную тему GitHub.
Автор: @Andcool-Systems
#### Поддерживаемые языки
* Русский - `ru`
* Английский - `en`.
#### Параметры
| Название | Описание | Обязательный | По умолчанию | Возможные значения |
|----------|--------------|--------------|---------------|-------------------------|
| timezone | Часовой пояс | Нет | `gmt0` | gmt(число от -14 до 12) |
#### Пример темы
### pixel-city
Города в стиле pixel art. Нарисовано нейросетью SDXL 1.0.
Автор: @wavy-cat
#### Поддерживаемые языки
* Русский - `ru`
* Английский - `en`
* Итальянский - `it`
* Испанский - `es` или `sp`
* Украинский - `ua` или `uk`
* Немецкий - `de`
* Португальский - `pt`
* Румынский - `ro`
* Польский - `pl`
* Финский - `fi`
* Голландский - `nl`
* Французский - `fr`
* Болгарский - `bg`
* Шведский - `sv` или `se`
* Китайский Традиционный - `zh_tw`
* Китайский Упрощённый - `zh` или `zh_cn`
* Турецкий - `tr`
* Хорватский - `hr`
* Каталанский - `ca`
#### Параметры
| Название | Описание | Обязательный | По умолчанию | Возможные значения |
|----------|------------------------------|--------------|--------------|-------------------------------------|
| size | Размер итогового изображения | Нет | `small` | `small` (512x358), `big` (1024x716) |
#### Пример темы
