Skip to content

Latest commit

 

History

History
69 lines (50 loc) · 2.92 KB

get-taxonomy-nodes.md

File metadata and controls

69 lines (50 loc) · 2.92 KB

Get taxonomy nodes

GET /api/delivery/projects/{projectId}/taxonomy/nodes

Get taxonomy nodes by path

GET: /api/delivery/projects/movieDb/taxonomy/nodes?path=root/movies/genres

Parameters

Name Parameter Type Type Format Description
projectId path string The project identifier, e.g. "movieDb". Found in the project overview screen of the management console
path query string The taxonomy path
language query string Language code [Optional] The language of the taxonomy name to retrieve. Defaults to the project default
childDepth query number integer [Optional] The maximum depth to which child nodes should be returned
order query string [Optional] How to order the child nodes. Defaults to alphabetical order, otherwise specify "defined" for the created order.

Example request

GET: /api/delivery/projects/movieDb/taxonomy/nodes?path=root/movies/genres/thriller&language=en-GB&childDepth=2&order=defined

Response messages

HTTP status code Reason Response model
200 Success A Taxonomy Node
500 Internal server error Error
404 Project not found Error
404 Project does not support the specified language Error
404 Taxonomy path does not exist Error

Get taxonomy nodes by key

GET: /api/delivery/projects/movieDb/taxonomy/nodes/0/1/2

Parameters

Name Parameter Type Type Format Description
projectId path string The project identifier, e.g. "movieDb". Found in the project overview screen of the management console
key path string The taxonomy key
language query string Language code [Optional] The language of the taxonomy name to retrieve. Defaults to the project default
childDepth query number integer [Optional] The maximum depth to which child nodes should be returned
order query string [Optional] How to order the child nodes. Defaults to alphabetical order, otherwise specify "defined" for the created order.

Example request

GET: /api/delivery/projects/movieDb/taxonomy/nodes/0/1/2?language=en-GB&childDepth=2&order=defined

Response messages

HTTP status code Reason Response model
200 Success A Taxonomy Node
500 Internal server error Error
404 Project not found Error
404 Project does not support the specified language Error
404 Taxonomy key does not exist Error