Pionera API documentation

Functions defined in Pionera can be called with an HTTP GET request. The response to the function you call is in JSON format. Browser plugins like JSONView for Firefox or Chrome will format and color Pionera's JSON response nicely in your browser.
Vocabulary Term (Class, Property, Datatype, Instance)

  • get/api/v2/term/search

    Search Term API v2
    The Search Term API allows a user to search over Ontology Hub ecosystem for a vocabulary term (class, property, datatype or instance).
    Parameter Type Description
    q string Full text query.
    page_size int Maximum number of results to return per page (default: 10).
    page int Result page to display starting from 1 (default: 1).
    type string Filter query results based on their type. Possible values: [class, propery, datatype, instance]. Multiple values allowed (use coma without space to seperate them).
    vocab string Filter query results based on the vocabulary it belongs to (e.g. "foaf"). Expecting only one value.
    vocab_limit int Number of elements to display in the vocabulary facet (default: 10).
    tag string Filter query results based on their tag (e.g. "event"). Multiple values allowed, use coma as a separator (e.g. "event,time").
    tag_limit int Number of elements to display in the tag facet (default: 10).
    For example, using the Pionera Search Term API, your app can search for all classes with the term "Person" in any litteral value: https://stics.iot.linkeddata.es/dataset/api/v2/term/search?q=Person&type=class

  • get/api/v2/term/autocomplete

    Autocomplete Term API v2
    The Autocomplete Term API allows a user to get autocompletion recommendations for terms in Ontology Hub ecosystem. The autocompletion is performed on terms URI (e.g. http://xmlns.com/foaf/0.1/Person) or terms prefixed URI (foaf:Person). The user can ask for autocompletion from 1 character and filter by type class or property.
    Parameter Type Description
    q string URI or prefixed URI to complete (from 1 character).
    type string Filter query results type: "property" or "class" (if no type is given, will search over property AND class types.)
    page_size int Maximum number of results to return per page (default: 10).
    For example, using the Autocomplete Term API, your app can search for all classes with terms URI or Prefixed URI begining with "foaf:": https://stics.iot.linkeddata.es/dataset/api/v2/term/autocomplete?q=foaf:p&type=class

  • get/api/v2/term/suggest

    Suggest Term API v2
    The Suggest Term API allows a user to get suggestion of vocabulary terms label based on the labels stored in Pionera. It is useful for instance to help fix some typos for a search engine.
    Parameter Type Description
    q string URI or prefixed URI to complete (from 1 character).
    type string Filter suggestions based on their type. Possible values: [class, propery, datatype, instance]. Multiple values allowed (use coma without space to seperate them).
    page_size int Maximum number of results to return per page (default: 10).
    For example, using the Suggest Term API, your app can get suggestion of misspelled query terms such as "preson": https://stics.iot.linkeddata.es/dataset/api/v2/term/suggest?q=preson

  • get/api/v2/term/search/metadata

    Metadata Term API v2
    The Metadata Term API allows a user to get metadata about one term in Ontology Hub ecosystem.
    Parameter Type Description
    q string URI, AltURI or FullName (as stated in Pionera) of a term in Pionera. This parameter is mandatory.
    For example, using the Metadata Term API, your app can get the metadata about the term "Schedule" in Pionera:https://stics.iot.linkeddata.es/dataset/api/v2/term/search/metadata?q=Schedule
Vocabulary

  • get/api/v2/vocabulary/list

    List Vocab API v2
    The List Vocab API allows a user to list the vocabularies part of the Ontology Hub ecosystem.
    Parameter Type Description
    - - -
    For example, using the List Vocab API, your app can list all vocabularies in Pionera: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/list

  • get/api/v2/vocabulary/search

    Search Vocab API v2
    The Search Vocab API allows a user to search over Ontology Hub ecosystem for a Vocabulary based on its title or prefix.
    Parameter Type Description
    q string Full text query.
    page_size int Maximum number of results to return per page (default: 10).
    page int Result page to display starting from 1 (default: 1).
    tag string Filter query results based on their tag (e.g. "event"). Multiple values allowed, use coma as a separator (e.g. "event,time").
    tag_limit int Number of elements to display in the tag facet (default: 10).
    lang string Filter query results based on their language (e.g. "french"). Multiple values allowed, use coma as a separator (e.g. "english,french").
    lang_limit int Number of elements to display in the language facet (default: 10).
    For example, using the Pionera Search Vocab API, your app can search for all vocabulary in English matching the term "Time": https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/search?q=time&lang=English

  • get/api/v2/vocabulary/autocomplete

    Autocomplete Vocab API v2
    The Autocomplete Vocab API allows a user to get autocompletion recommendations for vocabularies in Ontology Hub ecosystem. The autocompletion is performed on vocabulary URI (e.g. http://www.w3.org/2003/01/geo/wgs84_pos) or vocabulary prefix (geo). The user can ask for autocompletion from 1 character.
    Parameter Type Description
    q string URI or prefixed URI to complete (from 1 character).
    page_size int Maximum number of results to return per page (default: 10).
    For example, using the Autocomplete Vocab API, your app can search for all vocabularies with URI or Prefix begining with "geo": https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/autocomplete?q=geo

  • get/api/v2/vocabulary/info

    Info Vocab API v2
    The Info Vocab API allows a user to get details about one vocabulary.
    Parameter Type Description
    vocab string Prefix, URI or Namespace of a vocabulary in Pionera. This parameter is mandatory
    For example, using the Info Vocab API, your app can get the deatils about schema.org vocabulary: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/info?vocab=schema

  • get/api/v2/vocabulary/distributions_all

    Distribution API v2
    The Distribution API allows a user to list all distributions Ontology Hub ecosystem.
    Parameter Type Description
    - - -
    For example, using the Pionera Search Distribution API, your app can search for all distributions in Pionera https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/distributions_all
Artefact

  • get/api/v2/vocabulary/:artefact/distributions

    Distribution Artefact API v2
    The Distribution API allows a user to list all distributions about one vocabulary in Ontology Hub ecosystem.
    Parameter Type Description
    vocab string Prefix, URI or Namespace of a vocabulary in Pionera. This parameter is mandatory. The inserted vocabulary is equivalent to :artefact.
    For example, using the Distribution Artefact API, your app can list all distributions about a vocabulary Pionera: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/distributions?vocab=s4grid

  • get/api/v2/vocabulary/:artefact/distribution/latest

    Latest Artefact Distribution API v2
    The Latest Distribution API allows a user to get the latest distribution about one vocabulary in Ontology Hub ecosystem.
    Parameter Type Description
    vocab string Prefix, URI or Namespace of a vocabulary in Pionera. This parameter is mandatory. The inserted vocabulary is equivalent to :artefact.
    For example, using the Latest Distribution API, your app can list the last distribution about a vocabulary Pionera: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/distributions/latest?vocab=s4grid

  • get/api/v2/vocabulary/:artefact/distribution/:distributionID

    Distribution ID API v2
    The Distribution ID API allows a user to get a specific distribution about one vocabulary in Ontology Hub ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Ontology Hub ecosystem. This parameter is mandatory and a path parameter.
    :distributionID string ID of the distribution. This parameter is mandatory and a path parameter.
    For example, using the Distribution ID API, your app can a distribution about a vocabulary Pionera: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/s4grid/distributions/s4grid_v2

  • get/api/v2/vocabulary/:artefact/resources

    Vocab Resources API v2
    The Vocab Resources API allows a user to list all resources about one vocabulary in Ontology Hub ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Ontology Hub ecosystem. This parameter is mandatory and a path parameter.
    For example, using the Vocab Resources API, your app can list all resources about a vocabulary Pionera: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/s4grid/resources

  • get/api/v2/vocabulary/:artefact/resources/:resourceID

    Vocab Resource ID API v2
    The Vocab Resource ID API allows a user to get the resource ID about one vocabulary in Ontology Hub ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Ontology Hub ecosystem. This parameter is mandatory and a path parameter.
    :resourceID string ID of the resource. This parameter is mandatory and a path parameter. The query only works when its prefix and suffix are passed as parameters in :resourceID. Example: s4grid:DaySchedule.
    For example, using the Vocab Resource ID API, your app can list all resources from a specific resource about a vocabulary Pionera: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/s4grid/resources/s4grid:DaySchedule

  • get/api/v2/vocabulary/:artefact/resources/type/class

    Vocab Resource Classes API v2
    The Vocab Resource Classes API allows a user to list all classes about one vocabulary in Ontology Hub ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Ontology Hub ecosystem. This parameter is mandatory and a path parameter.
    For example, using theVocab Resource Classes API, your app can list all classes about a vocabulary Ontology Hub ecosystem: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/s4grid/resources/type/class

  • get/api/v2/vocabulary/:artefact/resources/type/property

    Vocab Resource Properties API v2
    The Vocab Resource Properties API allows a user to list all properties about one vocabulary in Ontology Hub ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Ontology Hub ecosystem. This parameter is mandatory and a path parameter.
    For example, using the Vocab Resource Properties API, your app can list all properties about a vocabulary Ontology Hub ecosystem: https://stics.iot.linkeddata.es/dataset/api/v2/vocabulary/s4grid/resources/type/property
Agent

  • get/api/v2/agent/list

    List Agent API v2
    The List Agent API allows a user to list all agents (Person or Organization) in Ontology Hub ecosystem.
    Parameter Type Description
    - - -
    For example, using the List Agent API, your app can list all agents in Pionera: https://stics.iot.linkeddata.es/dataset/api/v2/agent/list

  • get/api/v2/agent/search

    Search Agent API v2
    The Search Agent API allows a user to search over Ontology Hub ecosystem for an agent (person or organization).
    Parameter Type Description
    q string Full text query.
    page_size int Maximum number of results to return per page (default: 10).
    page int Result page to display starting from 1 (default: 1).
    type string Filter query results based on their type. Possible values: [person, organization].
    tag string Filter query results based on their tag (e.g. "event"). Multiple values allowed, use coma as a separator (e.g. "event,time").
    tag_limit int Number of elements to display in the tag facet (default: 10).
    For example, using the Pionera Search Agent API, your app can search for all person having a name containing "Pierre": https://stics.iot.linkeddata.es/dataset/api/v2/agent/search?q=Pierre&type=person

  • get/api/v2/agent/autocomplete

    Autocomplete Agent API v2
    The Autocomplete Agent API allows a user to get autocompletion recommendations for agents (Person or Organization) in Ontology Hub ecosystem. The autocompletion is performed on agent name (e.g. Food and Agriculture Organization) or agent URI (e.g. https://stics.iot.linkeddata.es/dataset/agents/Food%20and%20Agriculture%20Organization). The user can ask for autocompletion from 1 character.
    Parameter Type Description
    q string URI or prefixed URI to complete (from 1 character).
    For example, using the Autocomplete Agent API, your app can search for all agents with name or URI including "bern": https://stics.iot.linkeddata.es/dataset/api/v2/agent/autocomplete?q=bern

  • get/api/v2/agent/info

    Info Agent API v2
    The Info Agent API allows a user to get details about one agent in Pionera.
    Parameter Type Description
    agent string URI, AltURI or FullName (as stated in Pionera) of an agent in Pionera. This parameter is mandatory
    For example, using the Info Agent API, your app can get the details about W3C agent: https://stics.iot.linkeddata.es/dataset/api/v2/agent/info?agent=W3C