Get metadata taxonomy node by ID

Retrieves a metadata taxonomy node by its identifier.

GET /metadata_taxonomies/{namespace}/{taxonomy_key}/nodes/{node_id}

cURL

cURL

curl --request GET \
  --url https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes/{node_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "14d3d433-c77f-49c5-b146-9dea370f6e32",
  "displayName": "France",
  "level": 2,
  "parentId": "99df4513-7102-4896-8228-94635ee9d330",
  "nodePath": [
    "99df4513-7102-4896-8228-94635ee9d330"
  ],
  "ancestors": [
    {
      "id": "14d3d433-c77f-49c5-b146-9dea370f6e32",
      "displayName": "France",
      "level": 2
    }
  ]
}

このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。

「Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

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.

node_id · string · 必須

The identifier of the metadata taxonomy node.

レスポンス

200

application/json

Returns the metadata taxonomy node that matches the identifier.

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

id · string · 必須

A unique identifier of the metadata taxonomy node.

例:

"14d3d433-c77f-49c5-b146-9dea370f6e32"

displayName · string · 必須

The display name of the metadata taxonomy node.

例:

"France"

level · integer · 必須

An index of the level to which the node belongs.

例:

2

parentId · string

The identifier of the parent node.

例:

"99df4513-7102-4896-8228-94635ee9d330"

nodePath · string[]

An array of identifiers for all ancestor nodes.
Not returned for root-level nodes.

例:

["99df4513-7102-4896-8228-94635ee9d330"]

ancestors · Metadata taxonomy ancestor · object[]

An array of objects for all ancestor nodes.
Not returned for root-level nodes.

表示 子属性