Repolode
cloudflare

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. 1

    Установите библиотеку из PyPI

    pip install cloudflare
  2. 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-записи у множества провайдеров.

17,5 тыс.+25 за неделю1,9 тыс.GoMITОбновлён 5 дней назад

Лёгкое приложение для самостоятельного размещения, которое периодически обновляет DNS-записи A/AAAA у множества провайдеров и предоставляет веб-интерфейс.

3,3 тыс.+10 за неделю287GoMITОбновлён 7 дней назад

Самостоятельно размещаемый инструмент, который автоматически настраивает маршруты Cloudflare Tunnel, DNS-записи и политики Access по меткам Docker-контейнеров.

2,5 тыс.+4 за неделю107PythonOtherАктивно поддерживаетсяОбновлён в прошлом месяце

Панель управления для собственного сервера: развёртывание веб-приложений, управление базами данных, Docker-контейнерами, DNS, резервными копиями и безопасностью на VPS или выделенном сервере.

1,8 тыс.+19 за неделю183PythonMITАктивно поддерживаетсяОбновлён вчера