Catz bulk intefrace

Please note that the bulk interface described here are targeted to be used by www.catshow.fi. While the interface is made public it is subject to changes negotiated solely between catza.net and www.catshow.fi.

The request is sent as HTTP GET and a plain text document is retured. The first line returned is an informational header. The following lines contain the data using the pipe character as a column separator. The fields retuned are

  • URL to hires photo file
  • URL to the correspoding page on catza.net
  • The name of the cat in the photo

In case of an error 404 is returned.

Photos of the latest album

URL http://catza.net/en/bulk/photolist/ returns a list of the photos of the latest album having at least ten photos that have an indentified cat. The links to pages point to English pages. To get links to Finnish pages use http://catza.net/fi/bulk/photolist/.

Photos of any album by date and location

By providing additional parameters you can get a similar list of photos in any album. The required parameters are

  • d = date (YYYYMMDD or YYYY-MM-DD)
  • l = location

Examples of working requests:

Examples of non-working request returning 404:

Please verify the handling of the non-ASCII characters both in the request URL and in the response. Request http://catza.net/en/bulk/photolist?d=2010-03-07&l=Sein%E4joki contains an enocded ä and returns a result that includes a cat name Pörkarvan JakeSonOfJonatan that contains that can be used in verifying the data handling.