인증
Reigniter API API 키를 사용합니다. 각 키는 한 계정에 속하며 그 계정처럼 작동합니다: 그 계정의 크레딧을 사용하고 그 계정의 작업만 봅니다.
키 생성
섹션 제목: “키 생성”API 키는 Agency 계획의 일부입니다.
- Reigniter로그인하세요.
- 계좌 > API 열쇠 (
/app/account/api-keys). - 새 키 만들기(Create new key) 항목에 나중에 인식할 수 있는 라벨(예:
CI pipeline또는CMS sync)을 입력하세요. - 만들기를 선택하세요.
- 바로 키를 복사해.
키는 다음과 같습니다: emp_ 뒤에 64개의 16진수 문자가 따라옵니다.
열쇠 보내
섹션 제목: “열쇠 보내”모든 요청에 Authorization 헤더에 키를 베어러 토큰으로 넣으세요:
curl https://reigniter.ai/v1/me \ -H "Authorization: Bearer $REIGNITER_API_KEY"유효한 키는 계정에 200 반환됩니다:
{ "user_id": "3f1c2a9e-8b7d-4c1e-9f0a-2d6b5e4c3a21", "email": "dev@example.com", "name": "Sam", "credits_remaining": 42}열쇠가 거부될 때
섹션 제목: “열쇠가 거부될 때”| 현황 | code |
의미 |
|---|---|---|
401 |
NO_API_KEY |
Authorization 헤더가 없거나, 토큰이 emp_로 시작하지 않습니다. |
401 |
INVALID_API_KEY |
열쇠는 알려지지 않았거나 취소된 상태입니다. |
402 |
PLAN_UPGRADE_REQUIRED |
키는 유효하지만, 해당 계정은 Agency 요금제에 포함되어 있지 않습니다. |
403 |
ACCOUNT_SUSPENDED |
키를 소유한 계정은 정지됩니다. |
계정이 Agency 요금제에서 벗어나면, 다시 Agency될 때까지 키가 작동하지 않습니다.
열쇠를 비밀로 유지하세요
섹션 제목: “열쇠를 비밀로 유지하세요”- 키를 비밀 관리자나 환경 변수에 저장하세요. 절대 소스 컨트롤에 커밋하지 마세요.
- 서버에서만 API 에 전화하세요. 웹페이지나 모바일 앱에서 키를 절대 보내지 마세요. 브라우저 요청은 API 의 CORS 정책상 허용되지 않습니다.
- 시스템당 한 개의 키를 사용하고, 명확한 라벨을 붙이세요. 그러면 다른 키는 깨지지 않고 하나를 철회할 수 있습니다.
- API 키 화면에는 각 키가 마지막으로 사용된 시점이 표시됩니다. 모르는 키나 사용하지 말아야 할 키는 취소되어야 합니다.
열쇠를 취소하세요
섹션 제목: “열쇠를 취소하세요”- 계좌 열기 > API 키 열기.
- 활성 키에서 키를 레이블로 찾으세요.
- 취소 키(빈) 아이콘을 선택하세요.
취소된 키는 즉시 거부됩니다 401 INVALID_API_KEY. 취소는 되돌릴 수 없습니다. 이미 키로 렌더링을 시작한 상태에서 계속 실행됩니다.