Get Concept from Vocabulary

Description

Retrieves information about a concept.

Syntax

/content/vocabulary/concept/{vocName}?{queryString}

NOTE: vocName is the vocabulary identifier in the describes resource URI for the vocabulary (for example, SciValFunders).

Input Parameters

The input parameters for the query string are described in the following table.

Parameter

Required?

Multiple Instances Allowed?

Description

conceptURI

OR

conceptName

Yes

No

The URI of a specific concept in the vocabulary specified by vocName.

The exact string match on the preferred label of a concept (for example, National Aeronautics and Space Administration), or an alternative label of a concept (for example, NASA) in the vocabulary specified by vocName. The conceptName is case-insensitive.

Results

The entire concept record from the vocabulary is returned in JSON format.

Example Queries

Example 1 Query: Retrieving Concept Information Using Its URI

The following call retrieves the RDF fragment for a funding entity in the SciValFunders vocabulary whose unique ID is 100000193:

http://data.elsevier.com/content/vocabulary/concept/SciValFunders?conceptURI=http://data.elsevier.com/vocabulary/SciValFunders/100000193

Example 2 Query: Retrieving Concept Information Using a Label

The following call retrieves the RDF fragment for a funding entity in the SciValFunders vocabulary that has the label NEA:

http://data.elsevier.com/content/vocabulary/concept/SciValFunders?conceptName=nea

Results of Both Examples

Both example queries return the following result:

{"concepts":

[{"id":"http://data.elsevier.com/vocabulary/SciValFunders/100000193",

"inScheme":{

"value":"",

"resource":"http://data.elsevier.com/vocabulary/SciValFunders"},

"prefLabel":{"label":{"literalForm":{"value":"National Endowment for the Arts","lang":"en"}}},

"altLabel":[{"label":{"literalForm":{"value":"NEA","lang":"en"}}}],

"modified":["2011-10-24T13:30:53"],

"created":["2009-07-06T18:53:11"],

"fundingBodyType":["gov"],

"country":[{"resource":"http://sws.geonames.org/6252001/"}],

"state":[{"resource":""}],

"fundingBodySubType":["federal"]

}]

}

Error Return Codes

If an error occurs, the following standard HTTP error response codes are returned:

  • 500: A server-side error unrelated to the client query (for example, the server is down, or the code contains a null pointer).
  • 4xx: A client-side error; specifically for this API, one of the following:
    • 400: There is a syntax error in the query (for example, the query is missing a required parameter or includes an invalid argument).
    • 404: No content exists (for example, there is no match for the concept URI).
    • 405: The call is using an HTTP method that is not supported for this API

Along with the error, a text message that briefly explains the problem is returned.

The following error messages can also be returned by this API:

  • Authentication Error Occurred. Authentication Failure. An invalid vocabulary identifier was provided.
  • Invalid request. Missing mandatory param: conceptURI. A concept URI was not provided in the API call.

If a valid query returns 0 results, an empty result set is returned.

Contact Us About Elsevier Terms and Conditions Privacy Policy

Copyright © 2017 Elsevier B.V.  All rights reserved.