メインコンテンツへスキップ
Tiro APIは、ノート、トランスクリプト、サマリー、音声処理へのプログラムによるアクセスを提供します。

​
Base URL

すべてのAPIリクエストは、次のURLに対して行ってください。 
https://api.tiro.ooo

​
Rate Limits

公平な利用とシステムの安定性を確保するため、Tiro APIはAPIキーごとに60秒あたり600リクエストまで許可しています。超過すると、再試行のタイミングを示すRetry-After・X-RateLimit-*ヘッダーがレスポンスに含まれます。

​
Rate Limit Exceeded

rate limitを超過すると、429 Too Many Requestsレスポンスが返されます。 
{
  "error": {
    "code": 429001,
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "detail": "Limit of 600 requests per 60 seconds exceeded"
  }
}

​
レスポンス形式

すべてのAPIレスポンスは、一貫したJSON形式に従います。

​
成功レスポンス（リスト）

{
  "content": [...],
  "nextCursor": "opaque-cursor-string"
}

​
成功レスポンス（単一リソース）

{
  "id": "resource-id",
  "createdAt": "2024-01-01T00:00:00Z",
  ...
}

​
エラーレスポンス

エラーには、デバッグのための詳細な情報が含まれます。 
{
  "error": {
    "code": 400000,
    "message": "Human readable error message",
    "detail": null
  }
}