API アクセス

Tona はシンプルな REST API を提供しており、指示の作成やプロジェクト情報の取得をプログラムから行えます。独自ワークフロー、スクリプト、サードパーティツールに Tona を組み込みたい場合に便利です。

API 認証情報を確認する

1. プロジェクトを開き、サイドバーの Manual をクリックします。
2. ページ右上の Use API リンクをクリックします。
3. API Key、Base URL、Authorization Header が表示されます。

API キーはプロジェクトごとに一意です。公開せず、安全に管理してください。

利用できるエンドポイント

プロジェクト情報を取得する

プロジェクト名、説明、クレジット、接続済みプラットフォームアカウントを含む詳細を取得します。

Request:

GET /v1/project
Authorization: Bearer <your-api-key>

指示を作成する

ダッシュボードから送るのと同じように、新しい指示を Tona に送信します。投稿先プラットフォーム、コンテンツプロンプト、必要に応じて画像添付を指定できます。

Request:

POST /v1/instructions
Authorization: Bearer <your-api-key>
Content-Type: application/json

{
  "platformAccountIds": ["<account-id>"],
  "content": "Post a tweet about our new product launch",
  "images": ["https://example.com/image.webp"]
}

プラットフォームアカウント ID は、Get Project エンドポイントを呼び出して取得できます。

Markdown としてコピーする

API ページでは Copy as Markdown をクリックすると、実際の API キーを含む API ドキュメント全文をクリップボードへコピーできます。自分用メモに貼り付けたり、チームの開発者に共有したりするときに便利です。

ヒント

• API キーは安全に扱う。 パスワードと同じように管理してください。漏えいした可能性がある場合は、サポートへ連絡してください。
• まずは 1 つのプラットフォームで試す。 連携時は、最初に 1 つのプラットフォームアカウントだけを対象にして動作を確認してから広げると安全です。