APIリファレンス

近日公開 — パブリックREST APIは現在ロードマップに含まれており、まだ利用できません。以下のドキュメントは計画中のAPI設計を説明しています。公開は変更履歴でお知らせします。

PostClaw REST APIを使用すると、投稿・プラットフォーム・自動化・AI生成をプログラムで管理できるようになります。

ベースURL： https://app.postclaw.fun/v1

認証

すべてのリクエストにBearerトークンが必要です。設定 → APIキーでAPIキーを生成してください。

curl https://app.postclaw.fun/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

キーにはスコープがあります：read、write、またはadmin。必要最小限のスコープを使用してください。

レート制限

レート制限ヘッダーはすべてのレスポンスに返されます：

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 119
X-RateLimit-Reset: 1743484800

エンドポイント

投稿

# 投稿一覧
GET /v1/posts?status=scheduled&limit=20

# 投稿を作成
POST /v1/posts
{
  "content": "Your caption here",
  "platforms": ["twitter", "linkedin"],
  "scheduled_at": "2026-04-01T09:00:00Z",
  "media_ids": ["media_abc123"]
}

# 投稿を取得
GET /v1/posts/{id}

# スケジュール済み投稿をキャンセル
DELETE /v1/posts/{id}

メディア

# メディアをアップロード
POST /v1/media
Content-Type: multipart/form-data
# 返り値: { "id": "media_abc123", "url": "...", "type": "image" }

# メディアライブラリ一覧
GET /v1/media?type=image&limit=50

プラットフォーム

# 接続済みアカウント一覧
GET /v1/platforms

# アカウントを切断
DELETE /v1/platforms/{id}

AI生成

# 投稿テキストを生成
POST /v1/ai/text
{
  "prompt": "Announce our new feature: dark mode",
  "platform": "twitter",
  "tone": "casual"
}

# 画像を生成
POST /v1/ai/image
{
  "prompt": "Clean minimal desk setup, natural light",
  "size": "1024x1024"
}

自動化

# 自動化一覧
GET /v1/automations

# 自動化を手動でトリガー
POST /v1/automations/{id}/trigger
{ "input": "https://example.com/article" }

Webhook

イベントを受け取るURLを登録します：

POST /v1/webhooks
{
  "url": "https://yoursite.com/postclaw-events",
  "events": ["post.published", "post.failed", "automation.completed"]
}

イベントのペイロード構造：

{
  "event": "post.published",
  "timestamp": "2026-04-01T09:00:05Z",
  "data": {
    "post_id": "post_xyz789",
    "platform": "twitter",
    "url": "https://twitter.com/user/status/..."
  }
}

エラーレスポンス

すべてのエラーは一貫した形式で返されます：

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Retry after 60 seconds.",
    "retry_after": 60
  }
}

一般的なエラーコード：unauthorized、forbidden、not_found、validation_error、rate_limit_exceeded、platform_error。

SDK

公式SDKは開発中です。現時点では任意のHTTPクライアントをご利用ください。APIはapp.postclaw.fun/docsで完全にドキュメント化されています（OpenAPI 3.1仕様のダウンロードも可能です）。