API: add support for private notes in XML

[Robert Jäschke]

Private notes of publication posts should be returned in XML or be accessible via links + XML. The same holds in principle for extra URLS of publication posts.

[Former user]

Commented by cschenk: Adding these features to the XML like so: --- [...] <post [...]> <bibtex [...]> <privnote>My note...</privnote> <extraurl href="..."> <extraurl href="..."> [...] </bibtex> </post> [...] --- could add a performance penalty because we would have to do a lot more queries (at least two in this case) to fetch this extra information.

Instead of adding this information to the "bibtex" element for the common post queries (like "/posts" or "/users/[username]/posts"), I suggest adding separate URLs where this extra information can be retrieved. What about this:

• /users/[username]/posts/[resourceHash]/privnote
• /users/[username]/posts/[resourceHash]/extraurls with a XML-Schema like the one above; just with the corresponding "privnote" and "extraurl" attributes. This way we would have a distinct location for POST/PUT/DELETE, too.

[Robert Jäschke]

Indeed a good idea. In principle there is no neccessity to include this already in the post lists, since an application using the API could easily retrieve this information on demand. Since there is no hurry to implement this feature, we have time to further discuss it.

[Robert Jäschke]

please discuss with us before start of implementation