계정 API

Postlark 계정을 관리합니다. 내보내기와 삭제 엔드포인트는 GDPR을 준수합니다 (데이터 이동권 및 잊힐 권리).

프로필 조회

GET /account/profile

인증된 사용자의 프로필과 현재 플랜을 반환합니다.

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

{
  "id": "usr_abc123",
  "email": "[email protected]",
  "name": "Jane Doe",
  "plan": "starter",
  "subscription_status": "active",
  "current_period_end": "2026-04-01T12:00:00Z",
  "cancel_at": null,
  "created_at": "2026-03-01T12:00:00Z"
}

필드	타입	설명
`subscription_status`	string	`none`, `active`, `canceling`, `past_due`, `paused` 중 하나
`current_period_end`	string\|null	현재 청구 기간 종료일 (ISO 8601)
`cancel_at`	string\|null	취소 예정일 (canceling 상태일 때)

구독 취소 철회

POST /account/subscription/resume

예정된 구독 취소를 철회하여 active 상태로 복원합니다. subscription_status가 canceling일 때만 사용 가능합니다.

curl -X POST https://api.postlark.ai/v1/account/subscription/resume \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

{
  "resumed": true
}

예정된 취소가 없을 경우 400 에러:

{
  "error": "bad_request",
  "message": "No pending cancellation to resume"
}

데이터 내보내기

GET /account/export

모든 블로그와 포스트(마크다운 원본)를 JSON으로 반환합니다. 백업이나 다른 플랫폼으로 이전할 때 사용하세요.

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

{
  "exported_at": "2026-03-26T10:00:00Z",
  "user_id": "usr_abc123",
  "blogs": [
    {
      "blog": {
        "slug": "my-blog",
        "name": "My Blog",
        "description": "A blog about AI"
      },
      "posts": [
        {
          "slug": "hello-world",
          "title": "Hello World",
          "content_md": "# Hello\n\nThis is my first post.",
          "tags": ["intro"],
          "status": "published",
          "created_at": "2026-03-10T09:00:00Z"
        }
      ]
    }
  ],
  "total_posts": 1
}

계정 삭제

POST /account/delete

계정과 모든 연관 데이터를 영구 삭제합니다:

활성 Paddle 구독을 즉시 취소
모든 KV 캐시 (포스트, 인덱스, 테마, 도메인 매핑) 삭제
R2에 저장된 모든 이미지 삭제
모든 블로그, 포스트, API 키, 포스트 팩을 DB에서 삭제
사용자 레코드와 Supabase Auth 계정 삭제

curl -X POST https://api.postlark.ai/v1/account/delete \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

{
  "deleted": true,
  "message": "Account and all data have been deleted"
}

권리	엔드포인트	설명
데이터 이동권	`GET /account/export`	모든 데이터를 JSON으로 다운로드
잊힐 권리	`POST /account/delete`	계정과 모든 데이터 삭제

두 엔드포인트 모두 Free 플랜을 포함한 모든 플랜에서 사용 가능합니다.

참고: 인증 | 블로그 API | 포스트 API