Repolode
Enviar
cloudflare

cloudflare/cloudflare-python

SDK oficial em Python para a REST API da Cloudflare, com clientes síncrono e assíncrono e requisições e respostas tipadas.

Ver no GitHubSite
Estrelas
516
Forks
159
Issues abertas
33
Último commit
anteontem

O que é?

cloudflare-python é o cliente oficial em Python para a REST API da Cloudflare. Ele permite que código Python gerencie recursos da Cloudflare, como zonas, contas e namespaces KV, por meio de chamadas de métodos, sem precisar escrever requisições HTTP manualmente. A biblioteca é compatível com Python 3.9 ou posterior e inclui definições de tipos para todos os parâmetros de requisição e campos de resposta.

O SDK oferece clientes síncrono (Cloudflare) e assíncrono (AsyncCloudflare), ambos baseados em httpx, além de um backend aiohttp opcional para o cliente assíncrono. Os métodos de listagem retornam iteradores com paginação automática, e os uploads de arquivos aceitam bytes, caminhos ou tuplas (nome do arquivo, conteúdo, tipo de mídia). As respostas são modelos Pydantic com os métodos auxiliares to_json() e to_dict().

O cliente inclui novas tentativas configuráveis com backoff exponencial, timeouts por requisição, uma hierarquia de exceções tipadas por código de status HTTP e acesso a respostas brutas ou em streaming. O código é gerado com Stainless, e endpoints não documentados podem ser chamados pelos métodos get e post do cliente.

Recursos principais

  • 01Clientes síncrono e assíncrono para a REST API da Cloudflare.
  • 02Definições de tipos para parâmetros de requisição e campos de resposta, com modelos de resposta Pydantic.
  • 03Iteradores com paginação automática para endpoints de listagem.
  • 04Novas tentativas automáticas com backoff exponencial, timeouts configuráveis e uma hierarquia de exceções baseada no código de status.
  • 05Backend aiohttp opcional para o cliente assíncrono.

Casos de uso

  • Automatizar a configuração de DNS e zonas com scripts Python ou ferramentas de infraestrutura.
  • Gerenciar contas da Cloudflare e dados KV em serviços Python assíncronos.
  • Chamar endpoints da API da Cloudflare em uma base de código tipada, com preenchimento automático no editor.

Início rápido

  1. 1

    Instale a biblioteca do PyPI

    pip install cloudflare
  2. 2

    Crie um cliente com seu token de API e chame a API

Antes de usar

  • É necessário um token de API da Cloudflare para fazer solicitações.
  • É necessário Python 3.9 ou posterior.

Em coleções

Bibliotecas de concorrência e assincronia

Tópicos

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

Perguntas frequentes

O que é cloudflare-python?
SDK oficial em Python para a REST API da Cloudflare, com clientes síncrono e assíncrono e requisições e respostas tipadas. cloudflare-python é o cliente oficial em Python para a REST API da Cloudflare. Ele permite que código Python gerencie recursos da Cloudflare, como zonas, contas e namespaces KV, por meio de chamadas de métodos, sem precisar escrever requisições HTTP manualmente. A biblioteca é compatível com Python 3.9 ou posterior e inclui definições de tipos para todos os parâmetros de requisição e campos de resposta.
cloudflare-python é gratuito? Qual é a licença?
cloudflare-python é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
cloudflare-python ainda é mantido?
Manutenção ativa. O último commit de cloudflare-python foi em 5 de nov. de 2026.
Para que posso usar cloudflare-python?
Automatizar a configuração de DNS e zonas com scripts Python ou ferramentas de infraestrutura. Gerenciar contas da Cloudflare e dados KV em serviços Python assíncronos. Chamar endpoints da API da Cloudflare em uma base de código tipada, com preenchimento automático no editor.
Como instalar cloudflare-python?
Instale a biblioteca do PyPI: pip install cloudflare Crie um cliente com seu token de API e chame a API
Onde consigo cloudflare-python?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cloudflare/cloudflare-python

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados