Skip to content

Latest commit

 

History

History
46 lines (23 loc) · 1.94 KB

README.md

File metadata and controls

46 lines (23 loc) · 1.94 KB

Bukk.it.i.zer

A powerful bukk.it retrieval API crafted carefully to provide appropriate images for all situations, should Ethan Marcotte not be available for the task.

If, and only if, Ethan Marcotte is not available to provide the right GIF for any occasion, you can issue the HTTP requests listed below, all of which redirect, if possible, to a bukk.it URL. To see it in action, you can try http://bukkit.tangentialism.com/, but don't get your hopes up.

Methods

GET /

Returns a random image of any format.

http://bukkit.tangentialism.com/

A random image of a duck

GET /index.FORMAT

Returns a random image of format FORMAT. So, GET /index.gif would return a random GIF.

http://bukkit.tangentialism.com/index.gif

A random gif of a sighing cat

GET /MATCHABLE-WORD.FORMAT

Returns a random image whose name includes MATCHABLE-WORD of format FORMAT. So, GET /hello.gif might return a GIF of a bear waving hello.

http://bukkit.tangentialism.com/hello.gif

A random gif of a bear waving hello

GET /MATCHABLE-WORD

Returns a random image whose name includes MATCHABLE-WORD, irrespective of its format. So, GET /gotime would return a random image of a kangaroo dropping a ball, pathetically.

http://bukkit.tangentialism.com/gotime

A random gif of a kangaroo dropping a ball, sadly

There are currently no plans for PUT, POST, or DELETE calls. Be happy this exists, and just pray that Ethan is available.

About

Bukk.it is an exhaustive resource of appropriate images for all occasions, administered and searchable by the critically-acclaimed meme researcher and GIF archivist Ethan Marcotte. Bukk.it.i.zer is something David Yee put together in 20 minutes. Now you can make an informed decision about geniuses.