Web Service Method: Request Narrower Concepts

Abstract

Description
Returns a list of narrower concepts of a given concept.

URL: /PoolParty/api/thesaurus/{project}/narrowers

Note

See Web Service Method: Request Child Concepts of Concept Schemes or Concepts when you don't want to be restricted to concepts as input parameter.

Request

Supported Methods
GET

Path Variables

Variable	Comment
`{project}`	The UUID or the URI supplement (textual identifier) of the project to be used.

HTTP Parameters

Parameter	Comment	Type	Required
concept	URI of the concept	String	true
properties	List of concept properties that should be fetched. E.g. you can choose a list like: `skos:altLabel, skos:hiddenLabel, skos:definition, skos:broader` See full list of Retrieve Properties in API Requests.	String	false
language	Only narrower concepts with labels in this language will be displayed. If no language is given, the default language of the project will be used.	String	false
transitive	If true, all transitive narrower concepts are returned instead of only direct narrower concepts.	Boolean	false
workflowStatus	Set to `true` in case a workflow is applied and workflow status should be retrieved. Default is `false`. See details: Using Workflow Status Information	boolean	false

ResponseReturns

Array of concepts of the selected PoolParty project.

Attribute	Type	Comment
`uri`	String	URI of the concept
`prefLabel`	String	Preferred label
`altLabels`	Array of Strings	Alternative labels
`hiddenLabels`	Array of Strings	Hidden labels
`definitions`	Array of Strings	Definitions

Example

Example Request

http://<server-url>/PoolParty/api/thesaurus/2480fdb4-6b25-4f4b-9790-c49c7082931d/narrowers?concept=http://vocabulary.semantic-web.at/doku/Oceania

Example Response

[
 {
  uri: "http://vocabulary.semantic-web.at/doku/Micronesia",
  prefLabel: "Micronesia"
 },
 {
  uri: "http://vocabulary.semantic-web.at/doku/Polynesia",
  prefLabel: "Polynesia"
 },
 {
  uri: "http://vocabulary.semantic-web.at/doku/Melanesia",
  prefLabel: "Melanesia"
 },
 {
  uri: "http://vocabulary.semantic-web.at/doku/Australia_and_New_Zealand",
  prefLabel: "Australia and New Zealand"
 }
]

In this section: