API 인증

Spark! API는 API 키로 인증해요. 모든 요청의 Authorization 헤더에 API 키를 포함하세요.

1. Settings → API → API Keys로 이동해요
2. "Create API Key"를 클릭해요
3. 키 이름을 지정해요(예: "프로덕션", "스테이징")
4. 권한을 설정해요(읽기 전용 또는 읽기·쓰기)
5. 키를 복사해 안전하게 보관해요

Authorization 헤더에 API 키를 포함해요.

Authorization: Bearer YOUR_API_KEY

API 요청에는 속도 제한이 있어요.

• 일반 요청 — 분당 100회
• 대량 작업 — 분당 10회
• 웹훅 — 무제한(발신)

모든 응답에 요청 속도 제한 헤더가 포함돼요.

• X-RateLimit-Limit — 허용되는 최대 요청 수
• X-RateLimit-Remaining — 남은 요청 수
• X-RateLimit-Reset — 제한이 초기화되는 시각의 Unix 타임스탬프

API 오류는 표준 HTTP 상태 코드를 반환해요.

• 400 — 잘못된 요청(유효하지 않은 매개변수)
• 401 — 인증되지 않음(API 키가 유효하지 않거나 없음)
• 403 — 접근 금지(권한 부족)
• 404 — 찾을 수 없음
• 429 — 요청이 너무 많음(요청 속도 제한)
• 500 — 서버 오류

• 프로덕션 — https://api.chargezen.com/spark/v1
• 샌드박스 — https://sandbox.chargezen.com/spark/v1