인증 방법

API 키 발급

인증 방법

Authorization 헤더

모든 API 요청에 Authorization 헤더를 포함해요.

Authorization: DDUBOT_API <URL 인코딩한 api_key>

예시

cURL: — 미리 인코딩한 키를 붙여넣으세요.

curl -X GET "https://chzzk-bot.ddutto.com/api/v1/roulette" \
  -H "Authorization: DDUBOT_API %EA%B0%80%EB%82%98%EB%8B%A4..."

JavaScript (fetch):

const API_KEY = 'YOUR_API_KEY';   // 대시보드에서 복사한 한글 키

const response = await fetch('https://chzzk-bot.ddutto.com/api/v1/roulette', {
  method: 'GET',
  headers: {
    'Authorization': 'DDUBOT_API ' + encodeURIComponent(API_KEY)
  }
});

const data = await response.json();

Python (requests):

import requests
from urllib.parse import quote

API_KEY = 'YOUR_API_KEY'   # 대시보드에서 복사한 한글 키

headers = {
    'Authorization': 'DDUBOT_API ' + quote(API_KEY)
}

response = requests.get(
    'https://chzzk-bot.ddutto.com/api/v1/roulette',
    headers=headers
)

data = response.json()

권한 (Scope)

API 키를 만들 때 필요한 권한을 골라야 해요. 지금은 읽기 권한만 제공하고, 쓰기 · 특수 권한은 선택할 수 있는 항목이 없어요.

지금 조회 엔드포인트가 있는 스코프

예약 스코프 — 발급 화면에서 고를 수는 있지만, 아직 이 스코프를 쓰는 API가 없어요.

Rate Limit

모든 API는 분당 15회의 요청 제한이 있어요. 이 15회는 키 하나가 아니라 계정 하나 기준이라, 키를 여러 개 발급해도 나눠 쓰게 돼요.

응답 헤더에서 Rate Limit 정보를 확인할 수 있어요. 단 200 · 403 · 429 에만 붙어요. 400(인증 실패·파라미터 오류)과 500 에는 이 헤더가 없어요.

오류 응답

인증 실패 시 다음과 같은 오류가 반환돼요.

{
  "success": false,
  "data": {
    "error": "잘못된 접근입니다."
  }
}

일반적인 오류 원인

API 키 관리

키 재발급

대시보드에서 언제든지 새 API 키를 발급받을 수 있어요.

키 삭제

API 키가 유출된 경우 즉시 대시보드에서 삭제하고 새로 발급받아요. 목록의 삭제 버튼을 누르면 그 키만 즉시 무효화돼요.

다음 단계