Skip to main content
Drives

ディレクトリの内容を取得

Drive のルートまたは指定ディレクトリ内のファイルとサブディレクトリを取得します。

Drive は現在 Beta 機能です。API 定義、レスポンス構造、動作は変更される可能性があります。ドキュメントの更新を確認し、本番環境で使用する前に互換性を検証してください。
GET /api/v1/forward/drives/entries

リクエストヘッダー

Header必須説明
AuthorizationはいBearer <PAT or SAT>

クエリパラメーター

パラメーター型必須説明
identity_idstringはい現在の認証範囲内の Identity ID。必ず 1 回だけ指定します。Identity レベルの SAT は、紐付けられた Identity のみを選択できます。
pathstringいいえディレクトリの相対パス。デフォルトは空文字列で、ルートを表します。
limitintegerいいえデフォルト 20、範囲 1～100。指定できるのは 1 回のみです。
page_tokenstringいいえ前回のレスポンスの next_page_token。初回は省略します。同じ認証情報のリソース範囲、Identity、ディレクトリで使用してください。最大 8192 バイトで、変更できません。

パスのルール

path を省略するか空文字列を指定するとルートを表します。空でないパスには以下のルールが適用されます：
  • projects/reports など、有効な UTF-8 の相対パスを使用します。/projects/reports や C:/projects/reports などの絶対パスは使用できません。
  • ディレクトリは / で区切ります。先頭・末尾・連続する /、バックスラッシュ、. および .. のパス要素は使用できません。
  • 先頭・末尾の空白、制御文字、%（projects%2Freports のようなエスケープ済み文字列を含む）は使用できません。
上記のルールはデコード後のパスに適用されます。クエリのエンコード：
  • path=projects/reports のように区切り文字 / を保持し、%2F にエンコードしないでください。
  • 中国語と予約文字には標準のフォーム URL エンコードを使用し、空白には + を使用します。

リクエスト例

curl --silent --show-error --fail-with-body -X GET \
  "https://api.qoder.com/api/v1/forward/drives/entries?identity_id=idn_xxx&path=projects&limit=20" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK 
{
  "entries": [
    {
      "path": "projects/demo",
      "name": "demo",
      "type": "directory"
    },
    {
      "path": "projects/readme.md",
      "name": "readme.md",
      "type": "file",
      "size": 2048,
      "etag": "example-etag",
      "last_modified": "2026-09-07T02:00:00Z"
    }
  ]
}

レスポンスフィールド

フィールド型説明
entriesarray現在のディレクトリの直下の項目をパスの辞書順で返します。ディレクトリが存在しない場合や空の場合は []。
entries[].pathstringDrive 内の相対パス。ディレクトリの末尾に / は付きません。
entries[].namestring現在の階層のファイル名またはディレクトリ名。
entries[].typestringfile または directory。
entries[].sizeintegerファイルサイズ（バイト）。0 バイトのファイルは 0、ディレクトリでは省略されます。
entries[].etagstringファイルの ETag。空でない場合に返され、ディレクトリでは省略されます。
entries[].last_modifiedstringファイルの最終更新時刻（RFC 3339）。時刻がない場合やディレクトリでは省略されます。
next_page_tokenstring次のページがある場合に返され、最終ページでは省略されます。次のリクエストの page_token にそのまま渡してください。

エラー

HTTPCode発生条件
400invalid_drive_pathパス、クエリ内のパスのエンコード、または Identity 識別子の形式が無効です。
400invalid_limitページサイズが 1～100 の整数ではないか、複数回指定されています。
400invalid_page_tokenページトークンが無効、変更済み、または別のリソース範囲、Identity、ディレクトリに使用されています。
400invalid_identity_ididentity_id が未指定、空、または複数回指定されています。
401—認証情報が未指定または無効です。Service Account Key は事前に SAT と交換してください。
403identity_mismatchIdentity レベルの SAT で別の Identity を選択しています。
404identity_not_found現在の認証範囲内に Identity が見つかりません。
500—内部サーバーエラー。
503drive_unavailableDrive のストレージ、署名、または依存機能が一時的に利用できません。

HTTP エラーレスポンス

{
  "type": "error",
  "request_id": "req_xxx",
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_drive_path",
    "message": "Invalid Drive path."
  }
}

レスポンスフィールド

フィールド型説明
typestring常に error。
request_idstringリクエスト追跡 ID。利用可能な場合に返されます。
error.typestringエラーの分類。例：invalid_request_error、authentication_error、permission_error、not_found_error、conflict_error、api_error。
error.codestring業務エラーコード。一部の共通エラーでは返されません。
error.messagestringエラーの説明。
入口での認証エラーは、異なるレスポンス構造になる場合があります。

関連情報

アップロード URL の取得

ダウンロード URL の取得

はじめに
Agent の定義
Agent 環境の設定
Agent にタスクを委任する
Agent 連携
Agent コンテキストの管理
アカウント
ベストプラクティス
お知らせ
API リファレンス