{"id":21652132,"url":"https://github.com/andcool-systems/weather-widget-api","last_synced_at":"2025-04-11T20:33:13.071Z","repository":{"id":189578526,"uuid":"680904210","full_name":"Andcool-Systems/weather-widget-api","owner":"Andcool-Systems","description":"Виджет погоды для вашего профиля GitHub","archived":false,"fork":false,"pushed_at":"2025-02-11T19:17:26.000Z","size":35324,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T16:23:39.289Z","etag":null,"topics":["api","pillow","pyowm","python3","widget"],"latest_commit_sha":null,"homepage":"https://weather.andcool.ru","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Andcool-Systems.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-20T19:19:39.000Z","updated_at":"2025-02-11T19:17:30.000Z","dependencies_parsed_at":"2023-10-14T18:27:54.118Z","dependency_job_id":"feb14215-0f1b-4ef6-a292-6be7971a356a","html_url":"https://github.com/Andcool-Systems/weather-widget-api","commit_stats":null,"previous_names":["andcool-systems/weather-widget-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andcool-Systems%2Fweather-widget-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andcool-Systems%2Fweather-widget-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andcool-Systems%2Fweather-widget-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andcool-Systems%2Fweather-widget-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Andcool-Systems","download_url":"https://codeload.github.com/Andcool-Systems/weather-widget-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248476607,"owners_count":21110321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","pillow","pyowm","python3","widget"],"created_at":"2024-11-25T07:51:19.966Z","updated_at":"2025-04-11T20:33:13.023Z","avatar_url":"https://github.com/Andcool-Systems.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Weather Widget\n\n![GitHub repo size](https://img.shields.io/github/repo-size/Andcool-Systems/weather-widget-api?style=for-the-badge\u0026logo=github\u0026logoColor=white\u0026labelColor=1A222E\u0026color=242B36\u0026cacheSeconds=0)\n\nВиджет погоды в виде изображения, который вы можете установить куда угодно, например, в readme своего профиля GitHub.\n\n## Подробнее об API\nAPI расположен на **GET** https://weather.andcool.ru/api  \nВсе ответы, полученные с endpoint'а /api на домене weather.andcool.ru будут кэшироваться на 2 часа, вне зависимости от переданного cache-control хедера.\n\n\u003e Для упрощения создания виджета, можете использовать конструктор на [сайте](https://weather.andcool.ru)\n\n### Параметры\n| Название | Описание                                      | По умолчанию | Возможные значения  | Обязательный |\n|----------|-----------------------------------------------|--------------|---------------------|--------------|\n| place    | Название населённого пункта на любом языке    | -            | Строка              | Да           |\n| language | Язык, который будет использоваться в картинке | ru           | Зависит от темы     | Нет          |\n| theme    | Используемая тема виджета                     | default      | default, pixel-city | Нет          |\n\nНекоторые темы могут иметь свои обязательные или необязательные параметры.\nПодробнее о них можно узнать в разделе [Темы](https://github.com/Andcool-Systems/weather-widget-api#темы).\n\n### Ошибки API\n\n| HTTP код | Возвращаемый code | Описание                                                     | Решение ошибки                                                                                                           |\n|----------|-------------------|--------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|\n| 404      | place_not_found   | Переданный населённый пункт не найден.                       | Передать корректное место.                                                                                               |\n| 400      | lang_not_found    | Переданный язык не найден.                                   | Передать язык, который поддерживает [тема](https://github.com/Andcool-Systems/weather-widget-api#темы).                  |\n| 400      | tz_not_found      | Переданный часовой пояс не найден (только в теме default).   | Передать корректный [код временной зоны](https://github.com/Andcool-Systems/weather-widget-api#параметры-тем).           |\n| 400      | theme_not_found   | Переданная тема не найдена.                                  | Указать [существующую тему](https://github.com/Andcool-Systems/weather-widget-api#темы).                                 |\n| 500      | internal_error    | Внутренняя ошибка (может возникнуть по разным причинам).     | Решения нету. Можете создать [Issue](https://github.com/Andcool-Systems/weather-widget-api/issues) с описанием проблемы. |\n\n\u003e Внутренние ошибки бывают двух видов: на уровне облачной функции, обрабатываемые в try-except и на уровне шлюза.\n\u003e Ошибки на уровне шлюза обычно являются более критичными, однако ошибки на уровне функции проще отследить, поэтому в Issue прикладывайте UUID код ошибки, если он присутствует.\n\n## Темы\n### default\n**Тема по умолчанию.**\nСодержит наибольшее количество информации о погоде. Подстроена под стандартную тёмную тему GitHub.\nАвтор: @Andcool-Systems\n\n#### Поддерживаемые языки\n* Русский - `ru`\n* Английский - `en`.\n\n#### Параметры\n| Название | Описание     | Обязательный | По умолчанию  | Возможные значения      |\n|----------|--------------|--------------|---------------|-------------------------|\n| timezone | Часовой пояс | Нет          | `gmt0`        | gmt(число от -14 до 12) |\n\n#### Пример темы\n![default theme](https://weather.andcool.ru/api?place=andcool\u0026timezone=gmt3)\n\n\n### pixel-city\nГорода в стиле pixel art. Нарисовано нейросетью SDXL 1.0.\nАвтор: @wavy-cat\n\n#### Поддерживаемые языки\n* Русский - `ru`\n* Английский - `en`\n* Итальянский - `it`\n* Испанский - `es` или `sp`\n* Украинский - `ua` или `uk`\n* Немецкий - `de`\n* Португальский - `pt`\n* Румынский - `ro`\n* Польский - `pl`\n* Финский - `fi`\n* Голландский - `nl`\n* Французский - `fr`\n* Болгарский - `bg`\n* Шведский - `sv` или `se`\n* Китайский Традиционный - `zh_tw`\n* Китайский Упрощённый - `zh` или `zh_cn`\n* Турецкий - `tr`\n* Хорватский - `hr`\n* Каталанский - `ca`\n\n#### Параметры\n| Название | Описание                     | Обязательный | По умолчанию | Возможные значения                  |\n|----------|------------------------------|--------------|--------------|-------------------------------------|\n| size     | Размер итогового изображения | Нет          | `small`      | `small` (512x358), `big` (1024x716) |\n\n#### Пример темы\n![default theme](https://weather.andcool.ru/api?place=nightcity\u0026theme=pixel-city\u0026size=small)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandcool-systems%2Fweather-widget-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandcool-systems%2Fweather-widget-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandcool-systems%2Fweather-widget-api/lists"}