Wiki
Clone wikiBibSonomy / documentation / api / methods / ListOfPostsForPerson
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&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