Hashdb api

From Insomnia 24/7 Wiki
Revision as of 11:28, 7 June 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, plain text password is returned.


What comes back if something is wrong?

When a hash is not in the database: 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.


Some special chars show up weird

Some chars will require you support the utf-8 charset. For an HTML page you can force this support by adding the following meta tag between your head tags:

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />


Is it free?

Yes, it is, and will continue to be free for the foreseeable future. We would appreciate it if you give us credit for it though.


I plan to use it in a pretty big site/application. How many 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.