Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Download ZIP
    • POST https://dev-ddb.fiz-karlsruhe.de/api/2/favourites/download


^ Back to top

...

FA16 | Retrieve public folders

GET

/favourites/folders/public

Query parameters

NameValueOccurenceDefaultRequired
institutionQuery for institution Once-Query string for institution
portalName of used portalOnceDDBOptional for DDB, for other portals required
offsetBeginn offset of resultsOnce0 (Solr default is used)Optional
sizeSize data of resultsOnce10 (Solr default is used)Optional

Response payload

Code Block
themeMidnight
titleFolderResult object
linenumberstrue
collapsetrue
{
	"query": "institution:"*"",
	"total": 2,
	"offset": 0,
	"size": 9999,
	"folders": [
		{
			"id": "Sjszo4cBdHmpxQQKUvah",
 			"portal": "NEWSPAPER",
 			"title": "Schiller 1",
			"description": "",
			"userId": "af43fc5bfa951c88e8e4b4574b39a65a",
			"publishingName": "hosc",
			"createdAt": 1682070262371,
			"updatedAt": 1683642142787,
			"bookmarksIds": ["MUSR_IcBosJ3rUWzmkLU"],
			"institutionIds": ["SV27RQJTWNOLJTNSG3ASNZSGNHBITQI2"],
			"blockingToken": "",
			"keywordTool": {
				"sentToAdmin": false
			},
			"blocked": false,
			"published": true
		},
		{
			"id": "rjwQKYgBdHmpxQQKKgSs",
 			"portal": "NEWSPAPER",
 			"title": "Schiller 2",
			"description": "",
			"userId": "af43fc5bfa951c88e8e4b4574b39a65a",
			"publishingName": "hosc",
			"createdAt": 1682070216141,
			"updatedAt": 1683642142482,
			"bookmarksIds": [],
			"institutionIds": ["SV27RQJTWNOLJTNSG3ASNZSGNHBITQI2"],
			"blockingToken": "",
			"keywordTool": {
				"sentToAdmin": false
			},
			"blocked": true,
			"published": true
		}
	]
}

Status codes

  • 200 = Folder(s) found
  • 400 = Missing search param(s)
  • 500 = Internal server error

Example call(s)

  • Retrieve folders by user
    • GET https://dev-ddb.fiz-karlsruhe.de/api/2/favourites/folders/public


^ Back to top

...

API calls for Use Cases

UC01 | Add bookmark

...