開発者向け

Onplana の上に構築する

コードからプロジェクトとタスクを読み書きし、変更をすぐに把握し、計画をレポートに取り込み、AI エージェントに作業させることができます。入口は 5 つあり、どれも作成した人として動作するトークンを使います。

5 つの入口

どれも今日から使えます。サンプルから始めて、それぞれのガイドに進んでください。

個人用アクセス トークンを使う REST API

[設定]の[開発者]でトークンを作成します。必要な権限とプロジェクトだけに絞り、有効期限を付けられます。トークンはあなたとして 1 つの組織の中で動作し、あなたにできること以上のことは決してできません。OpenAPI 3.1 の仕様がすべてのパスを説明しています。

無料プランを含むすべてのプラン

すべてのプロジェクトにわたる、自分の未完了タスク
curl https://api.onplana.com/api/tasks/mine \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

署名付き Webhook

22 種類のイベントのいずれかが起きると、Onplana は JSON ペイロードをあなたの URL に POST します。各配信には、あなたのシークレットで作成した本文の HMAC-SHA256 署名が付き、すべての試行が配信履歴に残ります。

Business プラン以上

タスクのステータスが変わったことを知る
curl -X POST https://api.onplana.com/api/webhooks \
  -H "Authorization: Bearer pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Status changes","url":"https://example.com/onplana","events":["task.status_changed"],"secret":"YOUR_SECRET"}'

OData のレポート フィード

プロジェクト、タスク、割り当て、リソース、タイムシートの行、カスタム フィールドの値、ベースラインを含む、読み取り専用の OData v4 フィードです。Power BI、Excel、またはデータ ウェアハウスから、レポートの権限を持つトークンで接続します。

Professional プラン以上

フィードから 5 件のタスクを読む
curl -u "token:pat_YOUR_TOKEN" \
  "https://api.onplana.com/api/odata/Tasks?$top=5"

AI エージェント向けの MCP サーバー

Claude、ChatGPT、Cursor などの MCP クライアントは、接続した人の権限で作業を読み、管理できます。クライアントはブラウザーでサインインするため、事前に登録するアプリはありません。

無料プランを含むすべてのプラン。同時に接続できるエージェントの数はプランに応じて増えます。

MCP クライアントに Onplana を追加する
{
  "mcpServers": {
    "onplana": { "url": "https://mcp.onplana.com/mcp" }
  }
}

コネクタ

作り始める前に、連携がすでにあるかを確認してください。各コネクタは個人用アクセス トークンでサインインし、最初に同じ確認を行います。

  • Microsoft Teams と Microsoft 365 Copilot:無料プランを含むすべてのプランで利用できます。
  • タスクへの SharePoint と OneDrive のファイル リンク:Professional プラン以上で利用できます。
  • Power Automate と Power Apps:コネクタは同じ API の上に構築済みで、まだ公開していません。
  • Zapier:アプリは同じ API の上に構築済みで、まだ公開していません。

コネクタのトリガーは Webhook を購読します:Business プラン以上。

コネクタの接続確認
curl https://api.onplana.com/api/organizations/current \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

リクエストの仕組み

  • トークンは Bearer トークンとして送ります。トークンは作成された組織に結び付いているため、リクエストに組織のヘッダーは必要ありません。
  • エラーは JSON で返り、表示できる文、コード、サポートへの問い合わせ時に伝える requestId を含みます。
  • 制限はパスのグループごとに決まっています。拒否されたリクエストは 429 と秒単位の Retry-After ヘッダーを返すので、その時間待ってから再試行してください。
  • 仕様は api.onplana.com/api/openapi.json にあるので、そこから任意の言語のクライアントを生成できます。

各入口に必要なプラン

料金表から読み取っているので、この一覧と料金ページは常に一致します。

使うものプラン
REST API と個人用アクセス トークン無料プランを含むすべてのプラン
WebhookBusiness プラン以上
OData のレポート フィードProfessional プラン以上
MCP サーバー無料プランを含むすべてのプラン
Microsoft Teams アプリと Copilot エージェント無料プランを含むすべてのプラン
SharePoint と OneDrive のファイル リンクProfessional プラン以上
コネクタのトリガー(Webhook を購読)Business プラン以上

開発者からの質問

SDK はありますか?

いいえ。API は OpenAPI 3.1 の仕様を持つ HTTPS 上の JSON なので、どの HTTP クライアントでも使えます。仕様から型付きのクライアントを生成することもできます。

API は別料金ですか?

いいえ。REST API とトークンは無料プランを含むすべてのプランで使えます。Webhook はBusiness プラン以上、OData フィードはProfessional プラン以上で使えます。

サーバー アプリケーションから多くのお客様の代わりに操作できますか?

OAuth ではまだできません。現在は各お客様が自分の連携用にトークンを作成し、そのトークンは作成した人として動作します。製品でそれ以上のことが必要な場合は、内容をお知らせください。

API の利用規約はどこにありますか?

開発者向けドキュメントの API 利用規約のページで、許容される利用、トークンが表すもの、互換性のない変更の告知方法を説明しています。

最初のトークンを作成しましょう

無料で登録し、[設定]の[開発者]を開いて、コードに必要な権限を持つトークンを作成してください。