Hashdb api

From Insomnia 24/7 Wiki
Revision as of 16:07, 27 March 2011 by imported>Wikiadmin
Jump to: navigation, search

What does it do?

The API interface allows you to retrieve passwords from the database in a single simple http request.

This means you can easily add hash lookups into your website or application.


How do I use it?

You send an HTTP request to http://insomnia247.nl/hash_api.php with the GET parameters type and hash.

So for example http://insomnia247.nl/hash_api.php?type=md5&hash=5f4dcc3b5aa765d61d8327deb882cf99 would return password.

No HTML or styling info is added. Just the blank, plaintext password is returned.


What comes back if something is wrong?

When a hash is not in the databse: Hash not found.
Invalid MD5 hash: Error: Not a valid MD5 hash.
Invalid SHA-1 hash: Error: Not a valid SHA-1 hash.
Invalid hash type: Error: Not a valid hash type.
Not all parameters are set: Error: Both a 'hash' and 'type' need to be defined.

I plan to use it in a pretty big site/application. How much requests can I make?

Though it should be able to handle a fair amount of requests, there's always going to be a limit. If you're planning to use it a lot, please contact us.

We can discuss if we'll be able to handle the amount of requests, or if you can perhaps set up your own local copy of the database.