Blipfoto API

Breaking changes - legacy APIs will be disabled 6th January, 2014

Please note - the v1 and v2 APIs will be permanently disabled on Monday the 6th of January, 2014. If your app uses these APIs, you should migrate to v3 before this date to ensure your app continues to function correctly.

Migrating your app to v3 will require some fundamental changes, including updating resource URLs and handling the new authentication flow. You can read more about migration at the new developer site:

https://developer.blipfoto.com/docs/v3/migration

For further help with the v3 API, ask a question on the API forum or get in touch.

Documentation

If you're wanting to find out more about the API, you've come to the right place. Here you will find information on:

  • how to make calls to the service
  • request and response formats
  • the resources available to you
  • how to authenticate

We also have some FAQs as well as some sample code to help you get started. There may also be a 3rd party library for your favourite programming language - check the downloads page.

Requests

A request is made by accessing a URL, containing some additional parameters that identify your application and the type of data you want to receive.

Resources

The API contains a variety of resources, each performing a different task. For example, one resource can return search results, while another allows you to add a comment to a journal entry.

Each resource has a unique URL, adhering to a simple format. In addition, each resource has a set of parameters which can modify the data that is returned.

Responses

After making a request, the API will return its response to you. This contains the data you requested, as well as details of any errors that occurred.

The default response format is XML, but JSON, JSON-P and serialised PHP are also available.