Skip to main content

Web Service Method: Request Suggested Concept

Abstract

Web Service Method: Request Suggested Concept

Description

Provides details about a selected suggested concept.

Note

This service is equivalent to details you can find in the Suggested Concepts list in the Workflow Dashboardtab in the PoolParty frontend. For details refer to: Suggested Concepts Workflow

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

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 suggested concept

String

true

Response

HTTP status code 200 if OK + a JSON formatted response.

Attribute

Type

Comment

uri

String

URI of the concept

prefLabels

Object, containing label and language

Array of preferred labels of suggested concept. A suggested concept may carry labels in different languages.

definitions

Array of Strings

Suggested concepts may carry alternative labels.

broaderResources

Array of Strings

Suggested concepts may carry broader concepts.

relatedResources

Array of Strings

Suggested concepts may carry related concepts.

note

String

Suggested concepts may carry a note.

score

float

Custom score for the new concept between 0 and 1.

date

Date

Last modification date

Example

cURL Request

curl -u user:password -X GET "http://vocabulary.semantic-web.at/PoolParty/api/thesaurus/1DCE0ED2-D7E8-0001-86A1-18652DF0D7A0/suggestedConcept?concept=http://vocabulary.semantic-web.at/cocktails/4c6a85a7-de2a-42a9-9664-3279e53bac48"

Example Response

{
  "uri" : {
    "uri" : "http://vocabulary.semantic-web.at/cocktails/4c6a85a7-de2a-42a9-9664-3279e53bac48"
  },
  "prefLabels" : [ {
    "label" : "Calvados",
    "language" : "en"
  } ],
  "definitions" : [ ],
  "broaderResources" : [ ],
  "relatedResources" : [ ],
  "score" : 0.0,
  "date" : 1452700150000,
  "note" : ""
}