API 키와 인증

모든 요청은 조직에 발급된 API 키로 인증합니다. 키는 Authorization 헤더에 Bearer 토큰으로 담습니다.

curl https://api.pactery.com/v1/documents \
  -H "Authorization: Bearer sk_live_3f9a2c....."

키 종류

테스트 키로 만든 문서와 운영 키로 만든 문서는 서로 격리됩니다.

키 발급

조직 설정 → 개발자 → API 키에서 발급합니다. 키는 발급 직후 한 번만 전체 문자열이 표시되므로 안전한 곳에 보관하세요.

보안 수칙

• 키는 서버에서만 사용하세요. 브라우저·모바일 앱·깃 저장소에 노출 금지.
• 키가 유출되면 즉시 **폐기(rotate)**하세요. 폐기 즉시 기존 키는 무효화됩니다.
• 권한이 필요한 만큼만: 조직별로 키를 분리해 사고 범위를 줄이세요.

인증 실패

키가 없거나 잘못되면 401 Unauthorized가 반환됩니다.

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "API 키가 유효하지 않습니다."
  }
}