Repolode
제출하기
cloudflare

cloudflare/cloudflare-python

동기·비동기 클라이언트와 타입 지정 요청·응답을 제공하는 Cloudflare REST API 공식 Python SDK입니다.

GitHub에서 보기웹사이트
스타
516
포크
159
열린 이슈
33
마지막 커밋
그저께

어떤 프로젝트인가요?

cloudflare-python은 Cloudflare REST API를 위한 공식 Python 클라이언트입니다. 직접 HTTP 요청을 작성하는 대신 메서드를 호출해 Python 코드에서 zone, 계정, KV namespace와 같은 Cloudflare 리소스를 관리할 수 있습니다. Python 3.9 이상을 지원하며, 모든 요청 매개변수와 응답 필드의 타입 정의를 제공합니다.

동기식(Cloudflare) 및 비동기식(AsyncCloudflare) 클라이언트를 모두 제공하며, httpx를 기반으로 하고 비동기 클라이언트에서는 aiohttp 백엔드를 선택적으로 사용할 수 있습니다. 목록 조회 메서드는 자동으로 페이지를 넘기는 이터레이터를 반환하고, 파일 업로드에는 bytes, 경로 또는 (파일명, 내용, 미디어 유형) 튜플을 사용할 수 있습니다. 응답은 to_json() 및 to_dict() 헬퍼를 제공하는 Pydantic 모델입니다.

클라이언트에는 지수 백오프를 적용하는 설정 가능한 재시도, 요청별 타임아웃, HTTP 상태 코드에 따라 구분되는 타입 지정 예외 계층, 원시 또는 스트리밍 응답에 대한 접근 기능이 포함되어 있습니다. 코드는 Stainless로 생성되며, 문서화되지 않은 엔드포인트도 클라이언트의 get 및 post 메서드로 호출할 수 있습니다.

핵심 기능

  • 01Cloudflare REST API용 동기 및 비동기 클라이언트.
  • 02요청 매개변수와 응답 필드의 타입 정의 및 Pydantic 응답 모델.
  • 03목록 엔드포인트에서 자동으로 페이지를 넘기는 이터레이터.
  • 04지수 백오프를 적용하는 자동 재시도, 설정 가능한 타임아웃 및 상태 코드 기반 예외 계층.
  • 05비동기 클라이언트에서 선택적으로 사용할 수 있는 aiohttp 백엔드.

활용 사례

  • Python 스크립트나 인프라 도구에서 DNS 및 zone 설정 자동화.
  • 비동기 Python 서비스에서 Cloudflare 계정 및 KV 데이터 관리.
  • 에디터 자동 완성을 지원하는 타입 지정 코드베이스에서 Cloudflare API 엔드포인트 호출.

빠른 시작

  1. 1

    PyPI에서 라이브러리를 설치합니다

    pip install cloudflare
  2. 2

    API 토큰으로 클라이언트를 만들고 API를 호출합니다

사용 전 알아둘 점

  • 요청을 보내려면 Cloudflare API 토큰이 필요합니다.
  • Python 3.9 이상이 필요합니다.

포함된 컬렉션

동시성 및 비동기 라이브러리

토픽

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

자주 묻는 질문

cloudflare-python은(는) 무엇인가요?
동기·비동기 클라이언트와 타입 지정 요청·응답을 제공하는 Cloudflare REST API 공식 Python SDK입니다. cloudflare-python은 Cloudflare REST API를 위한 공식 Python 클라이언트입니다. 직접 HTTP 요청을 작성하는 대신 메서드를 호출해 Python 코드에서 zone, 계정, KV namespace와 같은 Cloudflare 리소스를 관리할 수 있습니다. Python 3.9 이상을 지원하며, 모든 요청 매개변수와 응답 필드의 타입 정의를 제공합니다.
cloudflare-python은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
cloudflare-python은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
cloudflare-python은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. cloudflare-python의 마지막 커밋은 2026년 11월 5일입니다.
cloudflare-python은(는) 어디에 사용할 수 있나요?
Python 스크립트나 인프라 도구에서 DNS 및 zone 설정 자동화. 비동기 Python 서비스에서 Cloudflare 계정 및 KV 데이터 관리. 에디터 자동 완성을 지원하는 타입 지정 코드베이스에서 Cloudflare API 엔드포인트 호출.
cloudflare-python는 어떻게 설치하나요?
PyPI에서 라이브러리를 설치합니다: pip install cloudflare API 토큰으로 클라이언트를 만들고 API를 호출합니다
cloudflare-python은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/cloudflare/cloudflare-python

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트