リファレンス

APIリファレンス

ホストされたOpenAPIリファレンスの場所、認証方法、すべての応答の形、レート制限。

Polylane APIの完全なリファレンスは、プラットフォームが提供するOpenAPI仕様から生成されるため、常にデプロイされているものと一致します。

APIリファレンスを開く

すべての操作、リクエストと応答の形、コピーできるリクエストのスニペット。

認証

ワークスペースのAPIキーをx-api-keyヘッダーで、またはOAuthアクセストークンをAuthorization: Bearerで送ります。どちらもコンソールで作成します。APIキーとOAuthクライアントを参照してください。

Terminal
curl https://api.polylane.com/v1/workspaces \
  -H "x-api-key: $POLYLANE_API_KEY"

応答形式

すべてのJSON応答は同じエンベロープを使います。

フィールド説明
successリクエストが成功したときはtrue、失敗したときはfalse。
message成功時は、messageが状態を説明するオブジェクト。失敗時はnull。
error成功時はnull。失敗時は、message、任意のdetail、任意のmetadataを持つオブジェクト。
result成功時のペイロード。失敗時は存在しません。
{
  "success": true,
  "message": { "message": "Successful request" },
  "error": null,
  "result": { "items": [], "count": 0 }
}

レート制限

対象制限
REST API認証情報ごとに60秒あたり5,000リクエスト
プラットフォームMCPサーバー認証情報ごとに60秒あたり600リクエスト

応答はRateLimit-LimitとRateLimit-Policyヘッダーでポリシーを示します。制限を超えると、APIはウィンドウの秒数を持つRetry-Afterヘッダー付きで429を返します。それが経過するまで待ってから再試行してください。

すべての操作は、同じ仕様から生成されるCLIからも呼び出せます。

関連