You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

API endpoints

SS01 | Store search

POST

/savedsearches

User permission required

Remarks

  • ?

Request payload

SavedSearch object
-

Response payload

SavedSearch object
-

Status codes

  • 200 = Bookmark created
  • 400 = Item Id is missing (required)
  • 400 = At least one folder id is missing (in portal DDB it must be at least id of folder "favorites")
  • 401 = User is not authorized
  • 500 = Internal server error

Example call(s)

  • Store search
    • ?

^ Back to top


SS02 | Retrieves searches

GET

/savedsearches

User permission required

Query parameters

NameValueOccurenceDefaultRequired
titleTitle of searchOnce-Optional
queryBase 64 coded search stringOnce-Optional
typeType of search like item, entity, institution or newspaperOnce-Optional

Response payload

SavedSearch object
-

Status codes

  • 200 = Bookmark(s) found
  • 400 = Missing some search params
  • 401 = User not authorized
  • 500 = Internal server error

Example call(s)

  • Retrieve searches by title
    • ?
  • Retrieve searches by search query
    • ?
  • Retrieve searches by type
    • ?

^ Back to top


SS03 | Update search

PUT

/savedsearches/{id}

User permission required

Request payload

SavedSearch object
-

Response payload

SavedSearch object
-

Status codes

  • 200 = Bookmark updated
  • 401 = User is not authorized
  • 404 = Bookmark ID not found
  • 500 = Internal server error

Example call(s)

  • Update search
    • ?

^ Back to top


SS04 | Delete search

DELETE

/savedsearches/{id}

User permission required

Response payload

SavedSearch object
-

Status codes

  • 200 = Bookmark deleted
  • 401 = User is not authorized
  • 404 = Bookmark ID not found
  • 500 = Internal server error

Example call(s)

  • Delete search
    • ?

^ Back to top


  • No labels