Catz bulk intefrace
2021-04-25: This interface had its practical use until summer 2014. It is still available but considered deprecated.
Listing the photos of an album
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 https://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 https://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:
- https://catza.net/en/bulk/photolist?d=2003-08-01&l=Helsinki (album not found)
- https://catza.net/en/bulk/photolist?d=20101224&l=Sein%E4joki (album not found)
- https://catza.net/fi/bulk/photolist?d=2004081&l=helsinki (invalid date)
- https://catza.net/fi/bulk/photolist?l=tampere&d=2010-209-05 (invalid date)
- https://catza.net/en/bulk/photolist?d=2010-03-07 (only date supplied)
- https://catza.net/en/bulk/photolist&l=seinajoki (only location supplied)
Please verify the handling of the non-ASCII characters both in the request URL and in the response. Request https://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.