How can you use it?

Make an API call (GET request) to the favi.co.nz API with your developer key. You can get one after creating an account.

http://favi.co.nz/api?k=[devkey]&u=[url]

Where [devkey] is your developer key, and [url] is the url you're requesting.

You'll get XML as return, with the url you requested and a link to the favicon (http://favi.co.nz/iconz/[hash].png.
If available you'll also get the site title.

<faviconz>
<status>OK</status>
<url>[url]</status>
<favicon>http://favi.co.nz/iconz/[hash].png<favicon>
</faviconz>

 

When no favicon is found you'll get:

<faviconz>
<status>ERROR</status>
<message>No favicon found</message>
</faviconz>

If incorrect API key used you'll get:

<faviconz>
<status>ERROR</status>
<message>Incorrect API key used</message>
</faviconz>

When you're out of credits you'll get:

<faviconz>
<status>ERROR</status>
<message>You're out of credits</message>
</faviconz>