Open Archives API » Comments/List

This method lists the approved comments made on records. Can be used by open archives to supplement their data with this user generated content.

URL

https://api.openarchieven.nl/1.0/comments/list.json

Method

GET

Input

Name	Required	Description	Default
archive	No	Filter returned comments on archive (see Stats/Archives for a list of valid archive codes)
number_show	No	Number of results to show (max=100)	10
since	No	Filter the results on date the links where created
callback	No	Function name to be called on JSON data

Output

The returned data in is JSON(P) format and contains the the selected comments, with the authors name (not validated), creation date and unique ID.

Example: https://api.openarchieven.nl/1.0/comments/list.json outputs:

[
	{
		"id": "986865669",
		"identifier": "1ab53c35-8f00-4208-d75e-eba4d0bef198",
		"archive": "elo",
		"name": "coret",
		"comment": "Catharina Angenita ('Kaatje') van Dam-Groeneveld (Leiden, 20 november 1887 - aldaar, 16 februari 2001) was van 14 augustus 1997 tot haar overlijden de oudste erkende levende persoon in Nederland.\r\n\r\nBron: http:\/\/nl.wikipedia.org\/wiki\/Catharina_van_Dam-Groeneveld",
		"created": "2013-08-03 09:41:05"
	},
	{
		"id": "986869268",
		"identifier": "44620ed1-75ba-310e-53b3-4b0acda8a3b1",
		"archive": "elo",
		"name": "coret",
		"comment": "Maria Catharina Swanenburg, beter bekend als Goeie Mie en de Leidse Gifmengster (Leiden, 9 september 1839 - Gorinchem, 11 april 1915) was een Nederlandse seriemoordenares. Ze vergiftigde in drie jaar tijd meer dan honderd van haar buurtgenoten van wie er zevenentwintig overleden, maar werd verdacht van het doden van meer dan negentig personen door vergiftiging.\r\n\r\nBron: http:\/\/nl.wikipedia.org\/wiki\/Maria_Swanenburg\r\n",
		"created": "2013-08-03 09:51:35"
	},
	{
		"id": "986871471",
		"identifier": "44620ed1-75ba-310e-53b3-4b0acda8a3b1",
		"archive": "elo",
		"name": "coret",
		"comment": "Zie ook http:\/\/www.inghist.nl\/Nieuws\/Tips\/Onderzoek\/Projecten\/BWN\/lemmata\/bwn2\/swanenburg",
		"created": "2013-08-03 09:58:01"
	},
	....
]	

Errors

One of the following errors may be thrown:

Error code	Error message
1	Invalid archive
2	Invalid identifier (syntax)
5	Invalid format
10	Invalid number_show
18	Invalid since

An example error looks (pretty-printed) like:

{
	"error_code": 18,
	"error_description": "Invalid email (syntax)"
}

Back to API documentation