|
Name | Value(s) | Required | Repeatable | Default value | Description |
---|---|---|---|---|---|
Accept | application/json */* | 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. |
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. |
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.
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. |
GET /institutions/sectors?oauth_consumer_key=abcdefgh12345678 HTTP/1.1 Host: api.deutsche-digitale-bibliothek.de Accept: application/xml |
|
GET /institutions/sectors HTTP/1.1 Host: api.deutsche-digitale-bibliothek.de Accept: */* Authorization: OAuth oauth_consumer_key="abcdefgh12345678" |
|