Description
The methodsortcriteria
of search
returns the available sort criteria and the default criterion of the search result sets. This method provides response data only as application/json
. It is a read-only service and must be accessed with a HTTP-GET-request.Request Header
Name | Value(s) | Required | Repeatable | Default value | Description |
---|---|---|---|---|---|
Accept | application/json application/xml */* | yes | no | application/json | Specifies the format of the accepted data. Every request needs to be sent with a valid Accept Header defining the requested response format. Otherwise the response to the request will be a 406 - Not acceptable status code. If the request accepts every kind of data (Accept: */* ) JSON will be returned. |
Authorization | OAuth oauth_consumer_key="<API key>" | yes | no | – | An API key is mandatory for data access. You may enclose it by either sending it as Query Parameter or (as mentioned here) in the Request Header. |
Host | api.deutsche-digitale-bibliothek.de | yes | no | – | The host is mandatory. |
Parameters
Query
Parameter | Value(s) | Required | Repeatable | Default value | Description |
---|---|---|---|---|---|
oauth_consumer_key | <API key> | yes | no | – | An API key is mandatory for data access. You may enclose it by either sending it as Query Parameter or (as mentioned here) in the Request Header. |
Authorization
This method needs an API key for authentication (Who are you?) and authorization (What you are authorized to do?). For more information please read the Authorization How-To.
This method is offered over HTTP and HTTP Secure.
Errors
Code | Text | Description |
---|---|---|
404 | Not Found | Either the item does not exist or has no data. |
406 | Not Acceptable | The Request Header is not acceptable. Please see section Request Header. |
500 | Server Error | Something went terribly wrong. An error message will provide a meaningful description. |
Samples
Request 1
Response