Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Update details on security to require HTTPS

The MILK Books API can be accessed with the following technologies in any programming language:

  • HTTP / (HTTPS specifically)
  • REST

The API is build built with the following technologies:

  • Microsoft C# .NET
  • ServiceStack

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.

Security

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.

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.

...

The API endpoint has a metadata page associated with it at /metadata i.e. httphttps://api.staging.milkbooks.com/metadata

The metadata page provides access to XSDs describing the types, as well as details about the API actions.

...