인증과 API 키

REST API는 서버에서 Authorization: Bearer 헤더에 API 키를 넣어 호출해요.


curl https://api.payri.kr/v1/orders \
  -H "Authorization: Bearer $PAYRI_API_KEY"

API 키를 브라우저나 앱에 넣지 마세요.
앱에서는 라이선스 앱 API를 써요.

키 형식

값	형식	용도
API 키	`pyr_live_…`, `pyr_test_…`	인증 헤더에 넣어요. 발급할 때 한 번만 보여요.
키 ID	`key_…`	콘솔과 로그에서 키를 구분해요. 인증에는 못 써요.

셀러 콘솔의 외부 연동 → API 키에서 새 키를 만들어요.

유예 중인 옛 키로 호출하면 응답에 Payri-Key-Deprecated: <만료 시각> 헤더가 와요.

코드	HTTP	의미
`API_KEY_INVALID`	401	인증 헤더가 없거나, 키가 올바르지 않거나, 회전 유예가 끝난 키예요.
`API_KEY_IP_NOT_ALLOWED`	403	요청 IP가 키의 허용 목록에 없어요.
`API_KEY_SCOPE_MISSING`	403	키에 필요한 권한이 없어요. `details.required`에 필요한 권한이 와요.