メインコンテンツへスキップ
GET
/
metadata_taxonomies
/
{namespace}
/
{taxonomy_key}
cURL
curl --request GET \
  --url https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key} \
  --header 'Authorization: Bearer <token>'
{
  "id": "822227e0-47a5-921b-88a8-494760b2e6d2",
  "displayName": "Geography",
  "namespace": "enterprise_123456",
  "key": "geography",
  "levels": [
    {
      "displayName": "Continent",
      "description": "Continent",
      "level": 1
    }
  ]
}
This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

認証

​
Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

パスパラメータ

​
namespace
string
必須

The namespace of the metadata taxonomy.

​
taxonomy_key
string
必須

The key of the metadata taxonomy.

レスポンス

Returns the metadata taxonomy identified by the taxonomy key.

A taxonomy object for metadata that can be used in metadata templates.

​
id
string
必須

A unique identifier of the metadata taxonomy.

例:

"822227e0-47a5-921b-88a8-494760b2e6d2"

​
displayName
string
必須

The display name of the metadata taxonomy. This can be seen in the Box web app.

Maximum string length: 4096
例:

"Geography"

​
namespace
string
必須

A namespace that the metadata taxonomy is associated with.

Maximum string length: 4096
例:

"enterprise_123456"

​
key
string

A unique identifier of the metadata taxonomy. The identifier must be unique within the namespace to which it belongs.

Maximum string length: 256
例:

"geography"

​
levels
Metadata taxonomy level · object[]

Levels of the metadata taxonomy.