Repolode
Enviar
cloudflare

cloudflare/cloudflare-python

SDK oficial de Python para la API REST de Cloudflare, con clientes síncronos y asíncronos, y solicitudes y respuestas tipadas.

Ver en GitHubSitio web
Estrellas
516
Forks
159
Issues abiertos
33
Último commit
anteayer

¿Qué es?

cloudflare-python es el cliente oficial de Python para la API REST de Cloudflare. Permite que el código Python gestione recursos de Cloudflare, como zonas, cuentas y espacios de nombres de KV, mediante llamadas a métodos en lugar de solicitudes HTTP escritas a mano. La biblioteca es compatible con Python 3.9 y versiones posteriores, e incluye definiciones de tipos para todos los parámetros de solicitud y los campos de respuesta.

Incluye clientes síncronos (Cloudflare) y asíncronos (AsyncCloudflare), basados en httpx, y un backend aiohttp opcional para el cliente asíncrono. Los métodos de lista devuelven iteradores con paginación automática, y las cargas de archivos aceptan bytes, rutas o tuplas (nombre de archivo, contenido, tipo de medio). Las respuestas son modelos de Pydantic con los métodos auxiliares to_json() y to_dict().

El cliente incluye reintentos configurables con espera exponencial, tiempos de espera por solicitud, una jerarquía de excepciones tipada según el estado HTTP y acceso a respuestas sin procesar o en streaming. El código se genera con Stainless, y es posible llamar a endpoints sin documentar mediante los métodos get y post del cliente.

Funciones clave

  • 01Clientes síncronos y asíncronos para la API REST de Cloudflare.
  • 02Definiciones de tipos para los parámetros de solicitud y los campos de respuesta, con modelos de respuesta de Pydantic.
  • 03Iteradores con paginación automática para los endpoints de lista.
  • 04Reintentos automáticos con espera exponencial, tiempos de espera configurables y una jerarquía de excepciones basada en el código de estado.
  • 05Backend aiohttp opcional para el cliente asíncrono.

Casos de uso

  • Automatizar la configuración de DNS y zonas mediante scripts de Python o herramientas de infraestructura.
  • Gestionar cuentas de Cloudflare y datos de KV en servicios asíncronos de Python.
  • Llamar a endpoints de la API de Cloudflare desde una base de código tipada con autocompletado en el editor.

Inicio rápido

  1. 1

    Instala la biblioteca desde PyPI

    pip install cloudflare
  2. 2

    Crea un cliente con tu token de API y llama a la API

Antes de usarlo

  • Necesitas un token de API de Cloudflare para realizar solicitudes.
  • Se requiere Python 3.9 o una versión posterior.

En colecciones

Bibliotecas de concurrencia y asincronía

Temas

#cloudflare#api#sdk#python#async#httpx#dns#sdk-python

Preguntas frecuentes

¿Qué es cloudflare-python?
SDK oficial de Python para la API REST de Cloudflare, con clientes síncronos y asíncronos, y solicitudes y respuestas tipadas. cloudflare-python es el cliente oficial de Python para la API REST de Cloudflare. Permite que el código Python gestione recursos de Cloudflare, como zonas, cuentas y espacios de nombres de KV, mediante llamadas a métodos en lugar de solicitudes HTTP escritas a mano. La biblioteca es compatible con Python 3.9 y versiones posteriores, e incluye definiciones de tipos para todos los parámetros de solicitud y los campos de respuesta.
¿cloudflare-python es gratuito? ¿Qué licencia tiene?
cloudflare-python es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿cloudflare-python sigue mantenido?
Mantenimiento activo. El último commit de cloudflare-python fue el 5 nov 2026.
¿Para qué puedo usar cloudflare-python?
Automatizar la configuración de DNS y zonas mediante scripts de Python o herramientas de infraestructura. Gestionar cuentas de Cloudflare y datos de KV en servicios asíncronos de Python. Llamar a endpoints de la API de Cloudflare desde una base de código tipada con autocompletado en el editor.
¿Cómo se instala cloudflare-python?
Instala la biblioteca desde PyPI: pip install cloudflare Crea un cliente con tu token de API y llama a la API
¿Dónde consigo cloudflare-python?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cloudflare/cloudflare-python

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados