Generic Resource Services

Abstract

A set of services that provide generic retrieval of RDF data. You can collect data from resources like skos:concept, skos:conceptScheme or even skos:collection.

These services can be used for example to collect details about custom scheme data a resource is applied to. To apply custom properties and types see Custom Properties & Types Service

Web Service Method: Request All Properties of a Resource

Abstract

Web Service Method: Request All Properties of a Resource

Description
Returns all properties of the selected resource (for example a concept) .

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

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
resource	URI of the resource	String	true

Response

A resource with all its properties.

Attribute	Type	Comment
`resource`	String	URI of the resource
`properties`	List of URIs	List of property URIs

Example

Example Request

http://<server>/PoolParty/api/thesaurus/1DCE0ED2-D7E8-0001-86A1-18652DF0D7A0/getProperties?resource=http://vocabulary.semantic-web.at/cocktails/2d85fb1b-96cb-4c48-8df5-707032f34e71

Example Response

{
    "resource": {
        "uri": "http://vocabulary.semantic-web.at/cocktails/2d85fb1b-96cb-4c48-8df5-707032f34e71"
    },
    "properties": [
        {
            "uri": "http://vocabulary.semantic-web.at/cocktail-ontology/served"
        },
        {
            "uri": "http://vocabulary.semantic-web.at/cocktail-ontology/preparation"
        },
        {
            "uri": "http://purl.org/dc/terms/creator"
        },
        {
            "uri": "http://purl.org/dc/terms/modified"
        },
        {
            "uri": "http://vocabulary.semantic-web.at/cocktail-ontology/uses_2"
        },
        {
            "uri": "http://vocabulary.semantic-web.at/cocktail-ontology/iba"
        },
        {
            "uri": "http://vocabulary.semantic-web.at/cocktail-ontology/consists-of"
        },
        {
            "uri": "http://purl.org/dc/terms/contributor"
        },
        {
            "uri": "http://www.w3.org/2004/02/skos/core#altLabel"
        },
        {
            "uri": "http://vocabulary.semantic-web.at/cocktail-ontology/uses"
        },
        {
            "uri": "http://schema.semantic-web.at/ppt/inScheme"
        },
        {
            "uri": "http://www.w3.org/2004/02/skos/core#broader"
        },
        {
            "uri": "http://www.w3.org/1999/02/22-rdf-syntax-ns#type"
        },
        {
            "uri": "http://purl.org/dc/terms/created"
        },
        {
            "uri": "http://vocabulary.semantic-web.at/cocktail-ontology/image"
        },
        {
            "uri": "http://www.w3.org/2004/02/skos/core#prefLabel"
        },
        {
            "uri": "http://www.w3.org/2004/02/skos/core#definition"
        },
        {
            "uri": "http://www.w3.org/2004/02/skos/core#exactMatch"
        }
    ]
}

Web Service Method: Request Property Values of a Resource

Abstract

Web Service Method: Request Property Values of a Resource

Description
Returns values of a specific property of a selected resource (e.g. a concept).

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

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
resource	URI of the resource	String	true
property	URI of the property	String	true

Response

Values of the selected property

Attribute	Type	Comment
`resource`	String	URI of the resource
`property`	String	URI of the property
`values`	List of values	Values the resource has

Example

Example Request

http://<server>/PoolParty/api/thesaurus/1DCE0ED2-D7E8-0001-86A1-18652DF0D7A0/getPropertyValues?resource=http://vocabulary.semantic-web.at/cocktails/2d85fb1b-96cb-4c48-8df5-707032f34e71&property=http://vocabulary.semantic-web.at/cocktail-ontology/image

Example Response

{
    "resource": {
        "uri": "http://vocabulary.semantic-web.at/cocktails/2d85fb1b-96cb-4c48-8df5-707032f34e71"
    },
    "property": {
        "uri": "http://vocabulary.semantic-web.at/cocktail-ontology/image"
    },
    "values": [
        {
            "uri": "http://upload.wikimedia.org/wikipedia/commons/thumb/3/37/MargaritaReal.jpg/440px-MargaritaReal.jpg"
        }
    ]
}

Web Service Method: Request Types of a Resource

Abstract

Web Service Method: Request Types of a Resource

Description
Returns a list of all rdf:types for the given resource (for example a concept).

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

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
resource	URI of the resource	String	true

Response

Types of the selected resource

Attribute	Type	Comment
`resource`	String	URI of the resource
`rdfTypes`	List of types	List of types that are applied to the resource

Example

Example Request Types of a skos:collection

http://<server>/PoolParty/api/thesaurus/1DCE0ED2-D7E8-0001-86A1-18652DF0D7A0/getTypes?resource=http://vocabulary.semantic-web.at/cocktails/8e00ef49-8beb-4e59-930a-a79dc05fd2bb

Example Response

{
    "resource": {
        "uri": "http://vocabulary.semantic-web.at/cocktails/8e00ef49-8beb-4e59-930a-a79dc05fd2bb"
    },
    "rdfTypes": [
        {
            "uri": "http://www.w3.org/2004/02/skos/core#Collection"
        }
    ]
}

In this section: