Wiki

Clone wiki

BibSonomy / documentation / api / methods / DetailsForConceptOfUser

Details for a concept for a user

Method GET
URL https://www.bibsonomy.org/api/users/[username]/concepts/[conceptname]

Status codes

  • 200 ok + bibsonomy/tags+xml

  • 400 bad request

  • 401 Unauthorized
  • 403 Forbidden

  • 500 Internal Server Error

Example

Request:

curl -XGET --user username:apikey "https://www.bibsonomy.org/api/users/username/concepts/datamining"

Response:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bibsonomy stat="ok">
    <tag name="datamining" globalcount="0" usercount="0" href="https://www.bibsonomy.org/api/tags/datamining">
        <subTags start="0" end="3">
            <tag name="classification" globalcount="0" usercount="1" href="https://www.bibsonomy.org/api/tags/classification"/>
            <tag name="clustering" globalcount="0" usercount="1" href="https://www.bibsonomy.org/api/tags/clustering"/>
            <tag name="ml" globalcount="0" usercount="1" href="https://www.bibsonomy.org/api/tags/ml"/>
        </subTags>
    </tag>
</bibsonomy>

XML Schema

<!--
  a tag
-->
<xsd:complexType name="TagType">
  <xsd:sequence>
    <xsd:element maxOccurs="unbounded" minOccurs="0" name="subTags" type="TagsType" />
    <xsd:element maxOccurs="unbounded" minOccurs="0" name="superTags" type="TagsType" />
  </xsd:sequence>
  <xsd:attribute name="name" type="xsd:string" use="required" />
  <xsd:attribute name="globalcount" type="positiveIntegerIncludingZero" />
  <xsd:attribute name="usercount" type="positiveIntegerIncludingZero" />
  <xsd:attribute name="score" type="probabilityValue" />
  <xsd:attribute name="confidence" type="probabilityValue" />
  <!-- link to details page -->
  <xsd:attribute name="href" type="xsd:anyURI" />       
</xsd:complexType>

Updated