REST Interface Description

Search for a concept

Conceptpower offers a search REST method. It can be used as follows:

http://[server.url]/conceptpower/rest/ConceptSearch?{list of fieldname=value}{operator=and/or}
          

Note: values should be encoded, e.g.:

http://my.server.edu/conceptpower/rest/ConceptSearch?creator=jdoe&concept_list=biology%20concepts&operator=and
          

The following fields can be queried:

• Equals to: equals_to
• Similar to: similar_to
• Description: description
• Word: word
• POS: pos
• Concept List: concept_list
• Type id: type_id
• Creator: creator
• Modified by: modified_by

The fields that are queried can be connected by "and" or "or" via the operator parameter; default is "or."
This method returns a list of found concepts like this:

<conceptpowerReply xmlns:digitalHPS="http://www.digitalhps.org/">
    <digitalHPS:conceptEntry>
       <digitalHPS:id 
          concept_id="CON273fb179-b256-4401-b094-614a5e215692" 
          concept_uri="http://www.digitalhps.org/concepts/CON273fb179-b256-4401-b094-614a5e215692">
              http://www.digitalhps.org/concepts/CON273fb179-b256-4401-b094-614a5e215692
       </digitalHPS:id>
       <digitalHPS:lemma>
           Adolf Ziegler
       </digitalHPS:lemma>
       <digitalHPS:pos>
           NOUN
       </digitalHPS:pos>
       <digitalHPS:description>
           German embryo modeler in late 19th century
       </digitalHPS:description>
       <digitalHPS:conceptList>
           Persons
       </digitalHPS:conceptList>
       <digitalHPS:creator_id>mueller</digitalHPS:creator_id>
       <digitalHPS:equal_to>http://viaf.org/viaf/38882290</digitalHPS:equal_to>
       <digitalHPS:modified_by/>
       <digitalHPS:similar_to/>
       <digitalHPS:synonym_ids/>
       <digitalHPS:type 
                 type_id="986a7cc9-c0c1-4720-b344-853f08c136ab" 
                 type_uri="http://www.digitalhps.org/types/TYPE_986a7cc9-c0c1-4720-b344-853f08c136ab">
           E21 Person
       </digitalHPS:type>
       <digitalHPS:deleted>false</digitalHPS:deleted>
       <digitalHPS:wordnet_id/>
    </digitalHPS:conceptEntry>
</conceptpowerReply>