Skip to main content
POST
保存済みの字幕の結果を一覧表示します。過去の結果を取得するには、nextCursor を beforeHistoryId として使用してください。

認証と権限

string
必須
このヘッダーに VoiceCheap API キーを指定してください。同じ API キーを Authorization: Bearer で送信することもできます。OAuth アクセストークンは MCP でのみ使用でき、この REST エンドポイントでは使用できません。
必要な権限: subtitles:read. 有効な有料サブスクリプションが必要です。権限によってチーム内のロール、リソースの所有権、メディアクレジット、プランの制限が変わることはありません。

パラメーター

integer
整数値。最小値: 1. 最大値: 100. デフォルト値: 30.
string
テキスト値。最小文字数: 1. 最大文字数: 160. パターン: ^[A-Za-z0-9_-]+$.
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

リクエスト例

例に記載されたリソース識別子とメディアキーを、ご自身のアカウントで返された値に置き換えてください。同じ変更操作を再試行する場合は、リクエスト識別子を変更しないでください。

レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 実行者が所有する編集可能な字幕履歴の概要と nextCursor を含む、ページ分割されたオブジェクト。

結果フィールド

操作の注意事項

  • 有料サブスクリプションとアクションの権限が必要です。実行時に、実行者の個人向けツールプランが再確認されます。認証情報がチームに関連付けられていても、保存済みツールとアップロード参照はその実行者に属します。
  • 成功したアクションは、API/MCP 共通の月間呼び出し枠を1回消費します。月間上限は Beginner が 500 回、Starter が 5,000 回、Creator が 25,000 回で、Pro、Scale、Enterprise に月間上限はありません。毎分の上限はそれぞれ 30、60、120、180、300、600 回で、引き続き適用されます。ツールの生成枠は別です。
  • limit のデフォルトは 30 で、1–100 の整数を指定できます。結果は新しい順に並びます。次のページでは nextCursor を beforeHistoryId として渡してください。null は、それ以前のページがないことを示します。
  • 返される項目は、個人用に保存されたWebツール履歴の概要です。永続的な連携の result_list コレクションとは異なり、ツールによる履歴保存はベストエフォートです。
  • この読み取りはメディアを生成せず、ツールの1日あたりの利用枠も消費しません。月間連携呼び出しの成功回数を1回消費します。
  • revision と hasEdits は保存済みの編集状態の概要を示します。編集後は lastEditedAt が含まれる場合があります。SRT と書式設定は subtitles_history_get で取得してください。

使用量

正常に実行された呼び出しごとに、月間 API/MCP 呼び出し回数を 1 回消費します。メディアクレジットと、その操作固有の生成枠も適用されます。

エラー