1. BibSonomy Avatar BibSonomy
  2. General
  3. BibSonomy

Wiki

Clone wiki

BibSonomy / documentation / api / methods / ListOfPostsForPerson

View History

List of all posts for a person

Method GET
URL https://www.bibsonomy.org/api/persons/[personid]/posts

Parameters

  • generic parameters can be found here
  • ?tags=[t1+t2+...+tn]: posts are tagged with these tags
  • ?resource=[hash]: posts for a specific resource
  • ?search=[search]: posts that contain the search terms
  • ?order=[order]: order of the posts. Only available if search parameter is present. Possible values:
    • added: order posts by adding time (desc)
    • rank: order posts by rank (score of the result)

Status codes

  • 200 ok

  • 400 bad request

  • 401 Unauthorized

  • 403 Forbidden

  • 500 Internal Server Error

Example

Request: 

curl  -XGET --user username:apikey "https://www.bibsonomy.org/api/persons/personid/posts?end=1"

Response: 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bibsonomy stat="ok">
    <posts start="0" end="1" next="https://www.bibsonomy.org/api/persons/personid/posts?start=1&amp;end=2">
        <post postingdate="2019-08-27T18:34:00.000+02:00" changedate="2019-08-27T18:34:00.000+02:00">
            <group name="public" href="https://www.bibsonomy.org/api/groups/public"/>
            <goldStandardPublication
                title="A title" bibtexKey="bibkey" entrytype="inproceedings"
                author="Max Mustermann" booktitle="A book title" crossref="cross/ref"
                editor="Max Mustermann" pages="1-100" publisher="A publisher"
                series="A series" volume="1" year="2019"
                url="https://www.bibsonomy.org" intrahash="intrahash" interhash="interhash"
            />
        </post>
    </posts>
</bibsonomy>

XML Schema

<!--
  this type encapsulated a list of posts
-->
<xsd:complexType name="PostsType">
  <xsd:sequence>
    <xsd:element name="post" type="PostType" minOccurs="0" maxOccurs="unbounded"/>
  </xsd:sequence>
  <xsd:attribute name="start" type="xsd:positiveInteger" use="required"/>
  <xsd:attribute name="end" type="xsd:positiveInteger" use="required"/>
  <xsd:attribute name="next" type="xsd:anyURI"/>
</xsd:complexType>

<!--
  a post
-->
<xsd:complexType name="PostType">
  <xsd:sequence>
    <xsd:element name="user" type="UserType"/>
    <xsd:element name="group" type="GroupType" minOccurs="0" maxOccurs="unbounded"/>
    <!-- Note: a post must have at least one tag -->
    <xsd:element name="tag" type="TagType" maxOccurs="unbounded"/>
    <xsd:element minOccurs="0" maxOccurs="1" name="documents" type="DocumentsType" />
    <xsd:choice>
      <xsd:element name="bookmark" maxOccurs="1" type="BookmarkType" />
      <xsd:element name="bibtex" maxOccurs="1" type="BibtexType" />
      <xsd:element name="publicationFileUpload" maxOccurs="1" type="UploadDataType" />
      <xsd:element name="goldStandardPublication" maxOccurs="1" type="GoldStandardPublicationType" />
    </xsd:choice>
 </xsd:sequence>
 <xsd:attribute name="description" type="xsd:string"/>
 <xsd:attribute name="postingdate" type="xsd:dateTime"/>
 <xsd:attribute name="changedate" type="xsd:dateTime" />
 <xsd:attribute name="score" type="probabilityValue" />
 <xsd:attribute name="confidence" type="probabilityValue" />
</xsd:complexType>

<!--
  a gold standard publication
-->
<xsd:complexType name="GoldStandardPublicationType">
    <xsd:complexContent>
        <xsd:extension base="AbstractPublicationType">
            <xsd:sequence>
                <xsd:element maxOccurs="1" minOccurs="1" name="references" type="ReferencesType" />
                <xsd:element name="publishedIn" type="PublishedInType" />
                <xsd:element maxOccurs="1" minOccurs="0" name="publications" type="PublicationsType" />
            </xsd:sequence>
        </xsd:extension>
    </xsd:complexContent>
</xsd:complexType>

<!--
  a abstract publication
-->
<xsd:complexType name="AbstractPublicationType">
    <!-- extra URLs -->
    <xsd:sequence>
      <xsd:element minOccurs="0" maxOccurs="1" name="extraurls" type="ExtraUrlsType" />
    </xsd:sequence>
    <xsd:attribute name="title" type="xsd:string" use="required" />
    <xsd:attribute name="bibtexKey" type="xsd:string" />
    <xsd:attribute name="bKey" type="xsd:string" />
    <xsd:attribute name="misc" type="xsd:string" />
    <xsd:attribute name="bibtexAbstract" type="xsd:string" />
    <xsd:attribute name="entrytype" type="xsd:string" />
    <xsd:attribute name="address" type="xsd:string" />
    <xsd:attribute name="annote" type="xsd:string" />
    <xsd:attribute name="author" type="xsd:string" />
    <xsd:attribute name="booktitle" type="xsd:string" />
    <xsd:attribute name="chapter" type="xsd:string" />
    <xsd:attribute name="crossref" type="xsd:string" />
    <xsd:attribute name="edition" type="xsd:string" />
    <xsd:attribute name="editor" type="xsd:string" />
    <xsd:attribute name="howpublished" type="xsd:string" />
    <xsd:attribute name="institution" type="xsd:string" />
    <xsd:attribute name="organization" type="xsd:string" />
    <xsd:attribute name="journal" type="xsd:string" />
    <xsd:attribute name="note" type="xsd:string" />
    <xsd:attribute name="number" type="xsd:string" />
    <xsd:attribute name="pages" type="xsd:string" />
    <xsd:attribute name="publisher" type="xsd:string" />
    <xsd:attribute name="school" type="xsd:string" />
    <xsd:attribute name="series" type="xsd:string" />
    <xsd:attribute name="volume" type="xsd:string" />
    <xsd:attribute name="day" type="xsd:string" />
    <xsd:attribute name="month" type="xsd:string" />
    <xsd:attribute name="year" type="xsd:string" />
    <xsd:attribute name="type" type="xsd:string" />
    <xsd:attribute name="url" type="xsd:string" />
    <xsd:attribute name="privnote" type="xsd:string" />

    <!-- hash value identifying this resource -->
    <xsd:attribute name="intrahash" type="xsd:string" />
    <xsd:attribute name="interhash" type="xsd:string" />
    <!-- link to all posts of this publication -->
    <xsd:attribute name="href" type="xsd:anyURI" />
</xsd:complexType>

Updated