Ffffound! Pre-emptive API

This is an experimental, pre-emptive API for Ffffound!. It's here for two reasons: providing related images to a screen saver, and demonstrating that OAuth support is not difficult. Contact me at mike-ffffound@teczno.com (watch for the Spamarrest reply) for more info.

List Images

Images from all users

Equivalent to viewing the front page of Ffffound.

Example: http://ffffound.teczno.com/home/;500.

Images from one user

Equivalent to viewing one user’s found, posted, or recommended images.

Example: http://ffffound.teczno.com/home/migurski/found;500.

Example response

<?xml version="1.0" encoding="UTF-8"?>
<images xmlns="http://ffffound.teczno.com/schema">
  <next href="http://ffffound.teczno.com/home/migurski/found;25" />
  <image href="http://ffffound.teczno.com/image/e20bbcfacf2f913cc889a2f7ae0feb443a0113be">
    <title>boiler design office</title>
    <link href="http://ffffound.com/image/e20bbcfacf2f913cc889a2f7ae0feb443a0113be?c=113016" />
    <content src="http://ffffound.com/static-data/assets/6/e20bbcfacf2f913cc889a2f7ae0feb443a0113be_m.jpg" />
    <thumbnail src="http://ffffound.com/static-data/assets/6/e20bbcfacf2f913cc889a2f7ae0feb443a0113be_xs.jpg" />
    <original src="http://www.oboiler.com/plugs/cleat2.jpg" />
    <referer href="http://www.oboiler.com/plugs/cleat.html" />
    <savedby count="2" />
  </image>
  <image href="http://ffffound.teczno.com/image/bd1a71811016b26d8fd511d6caf0498b64c83010">
    <title>breakfast</title>
    <link href="http://ffffound.com/image/bd1a71811016b26d8fd511d6caf0498b64c83010?c=113009" />
    <content src="http://ffffound.com/static-data/assets/6/bd1a71811016b26d8fd511d6caf0498b64c83010_m.jpg" />
    <thumbnail src="http://ffffound.com/static-data/assets/6/bd1a71811016b26d8fd511d6caf0498b64c83010_xs.jpg" />
    <original src="http://jonhuck.com/breakfast/images/meg%20cranston%202-3L.jpg" />
    <referer href="http://jonhuck.com/breakfast/pages/meg cranston 2-3L.htm" />
    <savedby count="1" />
  </image>
</images>

Single Images

View an image

Examples: http://ffffound.teczno.com/image/76587a649b1e7c53d9fcdd89939f8c11d6c190c0, http://ffffound.teczno.com/home/migurski/found/76587a649b1e7c53d9fcdd89939f8c11d6c190c0.

Example response

<?xml version="1.0" encoding="UTF-8"?>
<image xmlns="http://ffffound.teczno.com/schema" href="http://ffffound.teczno.com/image/76587a649b1e7c53d9fcdd89939f8c11d6c190c0">
  <title>Flickr Photo Download: WrocławCup 07</title>
  <link href="http://ffffound.com/image/76587a649b1e7c53d9fcdd89939f8c11d6c190c0" />
  <content src="http://ffffound.com/static-data/assets/6/76587a649b1e7c53d9fcdd89939f8c11d6c190c0_m.jpg" />
  <thumbnail src="http://ffffound.com/static-data/assets/6/76587a649b1e7c53d9fcdd89939f8c11d6c190c0_xs.jpg" />
  <original src="http://farm3.static.flickr.com/2182/1694963869_e1b545eb8f_o.jpg" />
  <referer href="http://www.flickr.com/photo_zoom.gne?id=1694963869&size=o" />
  <savedby count="2">
    <user href="http://ffffound.teczno.com/user/migurski">
      <name>migurski</name>
      <link href="http://ffffound.com/home/migurski" />
    </user>
  </savedby>
  <related>
    <image href="http://ffffound.teczno.com/image/8c64d2098fba588bec8919882231b35468135b36">
      <link href="http://ffffound.com/image/8c64d2098fba588bec8919882231b35468135b36" />
      <content src="http://ffffound.com/static-data/assets/6/8c64d2098fba588bec8919882231b35468135b36_m.jpg" />
      <thumbnail src="http://ffffound.com/static-data/assets/6/8c64d2098fba588bec8919882231b35468135b36_xs.jpg" />
    </image>
    <image href="http://ffffound.teczno.com/image/aadee3d6fcb9ea5b0452122a1ab18d7b27135f5f">
      <link href="http://ffffound.com/image/aadee3d6fcb9ea5b0452122a1ab18d7b27135f5f" />
      <content src="http://ffffound.com/static-data/assets/6/aadee3d6fcb9ea5b0452122a1ab18d7b27135f5f_m.jpg" />
      <thumbnail src="http://ffffound.com/static-data/assets/6/aadee3d6fcb9ea5b0452122a1ab18d7b27135f5f_xs.jpg" />
    </image>
    <image href="http://ffffound.teczno.com/image/6ba46cf7a89891f46ddcdf94d003f71df654eeb7">
      <link href="http://ffffound.com/image/6ba46cf7a89891f46ddcdf94d003f71df654eeb7" />
      <content src="http://ffffound.com/static-data/assets/6/6ba46cf7a89891f46ddcdf94d003f71df654eeb7_m.jpg" />
      <thumbnail src="http://ffffound.com/static-data/assets/6/6ba46cf7a89891f46ddcdf94d003f71df654eeb7_xs.jpg" />
    </image>
  </related>
</image>

Authenticated Methods

Note: these requests must be signed with OAuth.

Add an existing image

Example request body:

<?xml version="1.0" encoding="UTF-8"?>
<image xmlns="http://ffffound.teczno.com/schema" href="http://ffffound.teczno.com/image/76587a649b1e7c53d9fcdd89939f8c11d6c190c0"/>

Delete an existing image

Post a new image

Example request body:

<?xml version="1.0" encoding="UTF-8"?>
<image xmlns="http://ffffound.teczno.com/schema">
  <title>Flickr Photo Download: WrocławCup 07</title>
  <original src="http://farm3.static.flickr.com/2182/1694963869_e1b545eb8f_o.jpg"/>
  <referer href="http://www.flickr.com/photo_zoom.gne?id=1694963869&size=o"/>
</image>