인증

모든 API 요청에는 Authorization 헤더에 Bearer 토큰이 필요합니다.

API Key

Authorization: Bearer pk_live_xxxxxxxxxxxx

대시보드 → 설정 → API Keys에서 발급하세요. 각 키는 특정 블로그에 바인딩됩니다.

Rate Limit

플랜	시간당 요청
Free	60
Starter	300
Creator	1,000
Scale	10,000
Enterprise	10,000+

응답 헤더에 rate limit 정보가 포함됩니다:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1711324800

에러 형식

{
  "error": "not_found",
  "message": "Post not found"
}

상태 코드	에러 코드	설명
400	bad_request	잘못된 입력
401	unauthorized	API 키 누락 또는 무효
403	forbidden	플랜 업그레이드 필요 (upgrade_url 포함)
404	not_found	리소스 없음
409	conflict	중복 (slug, 도메인)
429	rate_limit_exceeded	Rate limit 초과 (retry_after 포함)
500	internal_error	서버 에러

Base URL

https://api.postlark.ai/v1

인터랙티브 문서: api.postlark.ai/docs