시작하기

인증

제품 연동에는 서버 측 API 키를, 워크스페이스 관리에는 브라우저 세션을 사용하세요.

API 키

고객 API 요청은 Authorization: Bearer re_…로 인증합니다. 키는 하나의 워크스페이스에 속하며, 브라우저, 모바일, 데스크톱, 템플릿, 이메일 콘텐츠에는 절대 포함해서는 안 됩니다.

요청 헤더
Authorization: Bearer re_your_key_here

브라우저 세션

대시보드는 HTTP 전용이며 폐기할 수 있는 세션 쿠키를 사용합니다. 결제 변경과 API 키 생성 또는 폐기에는 이 브라우저 세션이 필요하며 bearer 키로는 사용할 수 없습니다. bearer 키로는 GET /account로 같은 계정, 사용량, 결제 상태를, GET /analytics로 대시보드 분석을, GET /keys로 키 메타데이터(이름, 접두사, 마지막 사용)를 읽을 수 있습니다.

교체

  1. 인증된 대시보드 세션에서 교체용 키를 만듭니다.
  2. 교체용 키를 호출하는 모든 서비스에 배포합니다.
  3. 트래픽이 새 접두사를 사용하는지 확인합니다.
  4. 기존 키를 폐기합니다.

인증 실패

자격 증명이 없거나, 만료되었거나, 폐기되었거나, 알 수 없는 경우 표준 오류 엔벨로프와 함께 401이 반환됩니다. 인증 실패는 자동으로 재시도하지 마세요.

401 응답
{
  "error": {
    "message": "Unauthorized — provide a valid API key or session",
    "status": 401
  }
}