flickrex

{
  "arguments": {
    "argument": [
      {
        "_content": "Your API application key. <a href=\"/services/api/misc.api_keys.html\">See here</a> for more details.",
        "name": "api_key",
        "optional": 0
      },
      {
        "_content": "The name of the panda to ask for photos from. There are currently three pandas named:<br /><br />\n\n<ul>\n<li><strong><a href=\"http://flickr.com/photos/ucumari/126073203/\">ling ling</a></strong></li>\n<li><strong><a href=\"http://flickr.com/photos/lynnehicks/136407353\">hsing hsing</a></strong></li>\n<li><strong><a href=\"http://flickr.com/photos/perfectpandas/1597067182/\">wang wang</a></strong></li>\n</ul>\n\n<br />You can fetch a list of all the current pandas using the <a href=\"/services/api/flickr.panda.getList.html\">flickr.panda.getList</a> API method.",
        "name": "panda_name",
        "optional": "0"
      },
      {
        "_content": "A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_q</code>, <code>url_m</code>, <code>url_n</code>, <code>url_z</code>, <code>url_c</code>, <code>url_l</code>, <code>url_o</code>",
        "name": "extras",
        "optional": 1
      },
      {
        "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.",
        "name": "per_page",
        "optional": 1
      },
      {
        "_content": "The page of results to return. If this argument is omitted, it defaults to 1.",
        "name": "page",
        "optional": 1
      }
    ]
  },
  "errors": {
    "error": [
      {
        "_content": "One or more required parameters was not included with your request.",
        "code": "1",
        "message": "Required parameter missing."
      },
      {
        "_content": "You requested a panda we haven't met yet.",
        "code": "2",
        "message": "Unknown panda"
      },
      {
        "_content": "The API key passed was not valid or has expired.",
        "code": 100,
        "message": "Invalid API Key"
      },
      {
        "_content": "The requested service is temporarily unavailable.",
        "code": 105,
        "message": "Service currently unavailable"
      },
      {
        "_content": "The requested operation failed due to a temporary issue.",
        "code": 106,
        "message": "Write operation failed"
      },
      {
        "_content": "The requested response format was not found.",
        "code": 111,
        "message": "Format \"xxx\" not found"
      },
      {
        "_content": "The requested method was not found.",
        "code": 112,
        "message": "Method \"xxx\" not found"
      },
      {
        "_content": "The SOAP envelope send in the request could not be parsed.",
        "code": 114,
        "message": "Invalid SOAP envelope"
      },
      {
        "_content": "The XML-RPC request document could not be parsed.",
        "code": 115,
        "message": "Invalid XML-RPC Method Call"
      },
      {
        "_content": "One or more arguments contained a URL that has been used for abuse on Flickr.",
        "code": 116,
        "message": "Bad URL found"
      }
    ]
  },
  "method": {
    "description": {
      "_content": "Ask the <a href=\"http://www.flickr.com/explore/panda\">Flickr Pandas</a> for a list of recent public (and \"safe\") photos.\n<br/><br/>\nMore information about the pandas can be found on the <a href=\"http://code.flickr.com/blog/2009/03/03/panda-tuesday-the-history-of-the-panda-new-apis-explore-and-you/\">dev blog</a>."
    },
    "explanation": {
      "_content": "When calling this API method please ensure that your code uses the <strong>lastupdate</strong> and <strong>interval</strong> attributes to determine when to request new photos. <em>lastupdate</em> is a Unix timestamp indicating when the list of photos was generated and <em>interval</em> is the number of seconds to wait before polling the Flickr API again."
    },
    "name": "flickr.panda.getPhotos",
    "needslogin": 0,
    "needssigning": 0,
    "requiredperms": 0,
    "response": {
      "_content": "<photos interval=\"60000\" lastupdate=\"1235765058272\" total=\"120\" panda=\"ling ling\">\n    <photo title=\"Shorebirds at Pillar Point\" id=\"3313428913\" secret=\"2cd3cb44cb\"\n        server=\"3609\" farm=\"4\" owner=\"72442527@N00\" ownername=\"Pat Ulrich\"/>\n    <photo title=\"Battle of the sky\" id=\"3313713993\" secret=\"3f7f51500f\"\n        server=\"3382\" farm=\"4\" owner=\"10459691@N05\" ownername=\"Sven Ericsson\"/>\n    <!-- and so on -->\n</photos>"
    }
  },
  "stat": "ok"
}