メインコンテンツへスキップ
Box Hubのリストを取得する方法は、次の2とおりあります。 クエリパラメータを使用すると、結果の検索、スコープによる絞り込み、並べ替えが可能です。
Box Hubs endpoints require the box-version: 2025.0 header. If you omit this header, the API returns a 400 error with the message Missing required box-version header. Supported API versions: [2025.0]. For more information, see Box API versioning strategy.

​
リクエストしているユーザーのHubのリストを取得

認証済みユーザーがアクセスできるすべてのBox Hubを取得するには、エンドポイントを呼び出します。 
curl -i -X GET "https://api.box.com/2.0/hubs?scope=all&sort=name&direction=ASC" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "box-version: 2025.0"

​
クエリパラメータ (ユーザーのHubのリストを取得)

パラメータ型必須説明
querystringいいえBox Hubsの検索文字列。
scopestringいいえeditable、view_only、またはall。デフォルトはall。
sortstringいいえname、updated_at、last_accessed_at、view_count、またはrelevanceで並べ替え。デフォルトはrelevance。
directionstringいいえASCまたはDESC。
markerstringいいえマーカーベースのページネーション用のマーカー。
limitintegerいいえ1ページあたりの最大項目数 (1000以下にしてください)。

​
企業のHubのリストを取得

スコープが設定されている、企業の管理者またはHub共同管理者は、エンドポイントを使用して、企業のすべてのBox Hubのリストを取得できます。 
curl -i -X GET "https://api.box.com/2.0/enterprise_hubs?scope=all&sort=name&direction=ASC" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "box-version: 2025.0"
どちらのエンドポイントも、ページネーションフィールド (limit、next_marker) とともにHubのリストを返します。パラメータの詳細な説明と制限事項については、APIリファレンスを参照してください。