Braidrun SDK

Braidrun SDK는 개방형 플랫폼 API의 공식 타입 안전 클라이언트 모음입니다. 워크플로, 실행, 결과물, 수동 승인 및 Webhook 엔드포인트를 각 언어에 익숙한 메서드와 데이터 모델로 감싸므로 HTTP 요청과 응답 타입을 직접 작성할 필요가 없습니다.

지원 클라이언트

저장소에는 12개 언어를 지원하는 13개의 클라이언트 구현이 있습니다. 각 디렉터리는 패키지 메타데이터, API 모델, 테스트와 해당 언어의 전체 엔드포인트 문서를 포함하는 독립 클라이언트입니다.

API 지원 범위

각 언어 클라이언트는 동일한 공개 기능을 지원하며 메서드 이름은 언어 관례에 맞게 자동 변환됩니다.

빠른 시작

1. ‘계정 설정 → API 키’에서 키를 만들고 호출에 필요한 권한 범위만 부여합니다.
2. 기술 스택에 맞는 클라이언트를 선택하고 해당 디렉터리의 README를 엽니다.
3. 소스에서 종속성을 설치하고 환경 변수로 API Key를 구성합니다.
4. API 클라이언트를 만든 다음 먼저 워크플로 목록을 호출해 연결과 권한을 확인합니다.

python -m pip install "git+https://github.com/Braidrun/braidrun-sdk.git#subdirectory=python"

import os
import braidrun_sdk

configuration = braidrun_sdk.Configuration(
    host="https://braidrun.com",
    access_token=os.environ["BRAIDRUN_API_KEY"],
)

with braidrun_sdk.ApiClient(configuration) as client:
    workflows = braidrun_sdk.WorkflowsApi(client)
    result = workflows.list_workflows()
    print(result)

인증 및 권한

dyk_로 시작하는 API Key는 환경 변수나 비밀 관리 서비스에서 읽고 Bearer Header를 사용하는 것이 좋습니다. 실제 키를 소스 코드, 로그 또는 브라우저 프런트엔드에 기록하지 마세요. 각 엔드포인트는 여전히 해당 권한 범위를 확인하며, 클라이언트의 타입 안전성이 권한을 자동으로 부여하지는 않습니다.

API가 429를 반환하면 Retry-After를 따르고 X-RateLimit-Limit와 X-RateLimit-Window를 활용해 재시도 간격을 조정하세요.

SDK와 워크플로 엔진 선택 가이드

두 프로젝트 전체 소개 보기

관련 페이지

• API 개방형 플랫폼 개요
• API 키 관리
• 인증 및 속도 제한
• v1 엔드포인트에 대한 전체 참조
• Braidrun SDK GitHub 저장소 ↗