---
title: "API 인증: Spark! 문서 | Chargezen"
description: "Spark! API에 인증해요. Chargezen Spark! 문서의 API 참조 섹션에 있어요."
url: "https://chargezen.com/ko/docs/spark/api/authentication"
lang: "ko"
updated: "2026-01-19"
---

Canonical URL: https://chargezen.com/ko/docs/spark/api/authentication

# API 인증

Spark! API에 인증해요

마지막 업데이트: 2026-01-19

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

## API 키 발급

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

키를 비밀로 유지하세요

API 키는 Spark! 데이터에 대한 전체 접근 권한을 제공해요. 클라이언트 측 코드, 공개 저장소 또는 로그에 절대 노출하지 마세요.

## API 키 사용

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`

샌드박스 테스트

테스트에는 샌드박스 환경을 사용하세요. 프로덕션을 재현하지만 실제 데이터에 영향을 주거나 실제 지급을 실행하지 않아요.

## 다음 단계

[

### REST 엔드포인트

전체 엔드포인트 참조

자세히 보기



](https://chargezen.com/ko/docs/spark/api/endpoints)[

### 웹훅

이벤트 알림

자세히 보기



](https://chargezen.com/ko/docs/spark/api/webhooks)

### 관련 문서

[

#### REST 엔드포인트

API 엔드포인트 참조



](https://chargezen.com/ko/docs/spark/api/endpoints)[

#### 웹훅

이벤트 알림



](https://chargezen.com/ko/docs/spark/api/webhooks)

이 페이지가 도움이 되었나요?

도움이 더 필요하신가요? [고객 지원 문의](https://chargezen.com/ko/docs/checkoutos/troubleshooting/support)