Официальная клиентская библиотека TypeScript/JavaScript для Cloudflare REST API, сгенерированная с помощью Stainless.
cloudflare/cloudflare-python
Официальный Python SDK для Cloudflare REST API: синхронный и асинхронный клиенты, типизированные запросы и ответы.
- Звёзды
- 516
- Форки
- 159
- Открытые issues
- 33
- Последний коммит
- вчера
Что это?
cloudflare-python — официальный Python-клиент для Cloudflare REST API. Он позволяет управлять ресурсами Cloudflare, например зонами, аккаунтами и пространствами имён KV, с помощью вызовов методов вместо самостоятельно написанных HTTP-запросов. Библиотека поддерживает Python 3.9 и более поздние версии и включает определения типов для всех параметров запросов и полей ответов.
В библиотеке есть синхронный (Cloudflare) и асинхронный (AsyncCloudflare) клиенты на базе httpx; для асинхронного клиента также можно выбрать aiohttp. Методы для получения списков возвращают итераторы с автоматической пагинацией, а для загрузки файлов можно передавать bytes, пути или кортежи вида (имя файла, содержимое, тип медиаданных). Ответы представлены моделями Pydantic с методами to_json() и to_dict().
Клиент поддерживает настраиваемые повторы запросов с экспоненциальной задержкой, тайм-ауты для отдельных запросов, типизированную иерархию исключений по HTTP-статусу, а также доступ к необработанным ответам и потоковой передаче данных. Код сгенерирован с помощью Stainless; недокументированные конечные точки можно вызывать методами get и post клиента.
Ключевые возможности
- 01Синхронный и асинхронный клиенты для Cloudflare REST API.
- 02Определения типов для параметров запросов и полей ответов, а также модели ответов Pydantic.
- 03Итераторы с автоматической пагинацией для конечных точек, возвращающих списки.
- 04Автоматические повторы запросов с экспоненциальной задержкой, настраиваемые тайм-ауты и иерархия исключений на основе кодов статуса.
- 05Опциональный backend на aiohttp для асинхронного клиента.
Сценарии использования
- Автоматизация настройки DNS и зон с помощью Python-скриптов или инструментов управления инфраструктурой.
- Управление аккаунтами Cloudflare и данными KV в асинхронных Python-сервисах.
- Вызов конечных точек Cloudflare API из типизированного кода с автодополнением в редакторе.
Быстрый старт
- 1
Установите библиотеку из PyPI
pip install cloudflare - 2
Создайте клиент с помощью токена API и вызовите API
Что важно знать
- Для отправки запросов требуется токен API Cloudflare.
- Требуется Python версии 3.9 или новее.
В подборках
Темы
Частые вопросы
- Что такое cloudflare-python?
- Официальный Python SDK для Cloudflare REST API: синхронный и асинхронный клиенты, типизированные запросы и ответы. cloudflare-python — официальный Python-клиент для Cloudflare REST API. Он позволяет управлять ресурсами Cloudflare, например зонами, аккаунтами и пространствами имён KV, с помощью вызовов методов вместо самостоятельно написанных HTTP-запросов. Библиотека поддерживает Python 3.9 и более поздние версии и включает определения типов для всех параметров запросов и полей ответов.
- cloudflare-python можно использовать бесплатно? Какая у него лицензия?
- cloudflare-python распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- cloudflare-python всё ещё поддерживается?
- Активно поддерживается. Последний коммит в cloudflare-python — 5 нояб. 2026 г..
- Для чего можно использовать cloudflare-python?
- Автоматизация настройки DNS и зон с помощью Python-скриптов или инструментов управления инфраструктурой. Управление аккаунтами Cloudflare и данными KV в асинхронных Python-сервисах. Вызов конечных точек Cloudflare API из типизированного кода с автодополнением в редакторе.
- Как установить cloudflare-python?
- Установите библиотеку из PyPI: pip install cloudflare Создайте клиент с помощью токена API и вызовите API
- Где скачать cloudflare-python?
- Исходный код и инструкции по установке — на GitHub: https://github.com/cloudflare/cloudflare-python
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Лёгкая Go-утилита, которая автоматически определяет публичный IPv4/IPv6-адрес и обновляет DNS-записи у множества провайдеров.
Infrastructure as Code для DNS: описывайте DNS-записи в конфигурации на JavaScript и отправляйте их множеству провайдеров.
Лёгкое приложение для самостоятельного размещения, которое периодически обновляет DNS-записи A/AAAA у множества провайдеров и предоставляет веб-интерфейс.
Самостоятельно размещаемый инструмент, который автоматически настраивает маршруты Cloudflare Tunnel, DNS-записи и политики Access по меткам Docker-контейнеров.
Панель управления для собственного сервера: развёртывание веб-приложений, управление базами данных, Docker-контейнерами, DNS, резервными копиями и безопасностью на VPS или выделенном сервере.