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を取得するには、エンドポイントを呼び出します。box hubs --scope all --sort name --direction ASC
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"
await client.hubs.getHubsV2025R0({
scope: 'all',
sort: 'name',
direction: 'ASC' as GetHubsV2025R0QueryParamsDirectionField,
} satisfies GetHubsV2025R0QueryParams);
client.hubs.get_hubs_v2025_r0(scope="all", sort="name", direction=GetHubsV2025R0Direction.ASC)
await client.Hubs.GetHubsV2025R0Async(queryParams: new GetHubsV2025R0QueryParams() { Scope = "all", Sort = "name", Direction = GetHubsV2025R0QueryParamsDirectionField.Asc });
try await client.hubs.getHubsV2025R0(queryParams: GetHubsV2025R0QueryParams(scope: "all", sort: "name", direction: GetHubsV2025R0QueryParamsDirectionField.asc))
client.getHubs().getHubsV2025R0(new GetHubsV2025R0QueryParams.Builder().scope("all").sort("name").direction(GetHubsV2025R0QueryParamsDirectionField.ASC).build());
クエリパラメータ (ユーザーのHubのリストを取得)
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
query | string | いいえ | Box Hubsの検索文字列。 |
scope | string | いいえ | editable、view_only、またはall。デフォルトはall。 |
sort | string | いいえ | name、updated_at、last_accessed_at、view_count、またはrelevanceで並べ替え。デフォルトはrelevance。 |
direction | string | いいえ | ASCまたはDESC。 |
marker | string | いいえ | マーカーベースのページネーション用のマーカー。 |
limit | integer | いいえ | 1ページあたりの最大項目数 (1000以下にしてください)。 |
企業のHubのリストを取得
スコープが設定されている、企業の管理者またはHub共同管理者は、エンドポイントを使用して、企業のすべてのBox Hubのリストを取得できます。box hubs:enterprise --sort name --direction ASC
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"
await client.hubs.getEnterpriseHubsV2025R0({
scope: 'all',
sort: 'name',
direction: 'ASC' as GetEnterpriseHubsV2025R0QueryParamsDirectionField,
} satisfies GetEnterpriseHubsV2025R0QueryParams);
client.hubs.get_enterprise_hubs_v2025_r0(scope="all", sort="name", direction=GetEnterpriseHubsV2025R0Direction.ASC)
await client.Hubs.GetEnterpriseHubsV2025R0Async(queryParams: new GetEnterpriseHubsV2025R0QueryParams() { Scope = "all", Sort = "name", Direction = GetEnterpriseHubsV2025R0QueryParamsDirectionField.Asc });
try await client.hubs.getEnterpriseHubsV2025R0(queryParams: GetEnterpriseHubsV2025R0QueryParams(scope: "all", sort: "name", direction: GetEnterpriseHubsV2025R0QueryParamsDirectionField.asc))
client.getHubs().getEnterpriseHubsV2025R0(new GetEnterpriseHubsV2025R0QueryParams.Builder().scope("all").sort("name").direction(GetEnterpriseHubsV2025R0QueryParamsDirectionField.ASC).build());
limit、next_marker) とともにHubのリストを返します。パラメータの詳細な説明と制限事項については、APIリファレンスを参照してください。