The MILK Books API can be accessed with the following technologies in any programming language:
The API is built with the following technologies:
The API is hosted on Amazon Web Services (AWS) in the US-west region.
If you are also using .NET, using ServiceStack client libraries can offer a shortcut for API integration.
At this time, MILK doesn't maintain any native client libraries. This may change and may be requested.
All request to the API should be made over HTTPS for all environments (including staging and live).
Requests made over HTTP will time out and not get a response.
The API offers 4 serialization methods to send and retrieve data. The serialization method is selected using the Accept and Content-type HTTP headers. If you cannot specify the content type on the HTTP request, it can be overridden by appending a query string parameter to the URL.
Serialization | Header | Override |
---|---|---|
JSON | application/json | ?format=json |
XML | application/xml | ?format=xml |
CSV | text/csv | ?format=csv |
JSV | text/jsv | ?format=jsv |
JSON is the preferred serialization format. Additional serialization formats can be reqested if necessary.
The API endpoint has a metadata page associated with it at /metadata i.e. https://api.staging.milkbooks.com/metadata
The metadata page provides access to XSDs describing the types, as well as details about the API actions.