The MILK Books API can be accessed with the following technologies in any programming language:
- HTTP
- REST
The API is build with the following technologies:
- Microsoft C# .NET
- ServiceStack
If you are also using .NET, using ServiceStack client libraries can offer a shortcut for API integration.
Serialization
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.
Metadata
The API endpoint has a metadata page associated with it at /metadata i.e. http://api.staging.milkbooks.com/metadata