公開投稿APIの使い方
Zetterの公開投稿APIを使うと、bot・外部連携・ツールからZetterの共有タイムラインに投稿できます。
APIキーの発行
APIキーは1ユーザーにつき5本まで発行できます。キーは api/me/api-keys エンドポイント（ログインセッション必須）から発行します。発行時に生キーは一度だけ表示されるので、安全な場所に保存してください。
現在、キー管理UIはアプリ内の設定画面から利用できます。ブラウザの開発者ツールを使わずにキーの作成・一覧表示・無効化が可能です。
APIエンドポイント
POST /api/v1/posts
Authorization: Bearer <API_KEY>
Content-Type: application/json
{"content": "投稿本文（1〜1500文字）"}- スコープ:
posts:write - API投稿にはBOTバッジが自動付与され、
via_apiフラグがDBに記録されます - 投稿はキー所有者のアカウント名義で行われます
- メディア（画像・動画・音楽）の添付は現在非対応です
レート制限
- APIキーごと: 3回/分・30回/時・100回/日
- ユーザーごと（全キー合算）: 5回/分・60回/時
エラーコード
主なエラーコード: UNAUTHORIZED（Authorizationヘッダなし）、INVALID_API_KEY（キー形式不正）、API_KEY_REVOKED（キー無効化済み）、RATE_LIMITED（制限超過、Retry-Afterヘッダを確認）、DUPLICATE_CONTENT（10分以内の同一内容再投稿）。
詳細はリポジトリの docs/ecosystem/api-developer-guide.md を参照してください。