포스트 팩 API

포스트 팩은 월간 포스트 쿼터를 넘어서 추가로 발행할 수 있는 일회성 크레딧입니다. Starter 플랜 이상에서 사용 가능합니다.

팩 구매

POST /packs/purchase

파라미터	타입	필수	기본값	설명
pack_type	string	아니오	"100"	"100" ($10, 100포스트) 또는 "300" ($25, 300포스트)

curl

curl -X POST https://api.postlark.ai/v1/packs/purchase \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "pack_type": "100" }'

Response (200)

{
  "message": "Post Pack 100 purchase initiated. Complete payment via Paddle checkout.",
  "pack_type": "100",
  "price": "$10",
  "posts": 100
}

참고

기존 구독에 대한 Paddle 일회성 결제로 처리됩니다. 결제 완료 후 Paddle 웹훅을 통해 팩 잔고가 자동으로 반영됩니다.

잔고 조회

GET /packs/balance

총 남은 팩 크레딧과 각 팩의 상세 내역을 반환합니다.

curl

curl https://api.postlark.ai/v1/packs/balance \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

Response (200)

{
  "balance": 150,
  "packs": [
    {
      "balance": 50,
      "purchased_at": "2026-03-01T12:00:00Z"
    },
    {
      "balance": 100,
      "purchased_at": "2026-03-20T08:00:00Z"
    }
  ]
}

팩 소진 방식

포스트 팩은 월간 구독 쿼터를 보충하는 역할입니다:

1. 월간 쿼터가 먼저 소진 — 매 결제 주기마다 플랜에 포함된 포스트 수가 초기화됩니다
2. 초과분은 팩에서 차감 — 월간 쿼터를 모두 사용하면 가장 오래된 팩부터 차감됩니다
3. 팩은 만료되지 않음 — 미사용 크레딧은 무기한 이월됩니다
4. FIFO 순서 — 가장 먼저 구매한 팩부터 소진됩니다

팩	가격	포스트 수	포스트당 비용
Pack 100	$10	100	$0.10
Pack 300	$25	300	$0.083

주의

포스트 팩은 유료 구독(Starter+)이 필요합니다. Free 플랜에서는 403 에러와 함께 업그레이드 링크가 반환됩니다.

에러

상태	원인
400	잘못된 pack_type ("100" 또는 "300"만 허용)
400	블로그 미지정
403	Free 플랜 — 업그레이드 필요

---

참고: Rate Limits | 인증 | 블로그 API