Difference between revisions of "Hashdb api"

From Insomnia 24/7 Wiki
Jump to: navigation, search
imported>Wikiadmin
imported>Wikiadmin
Line 20: Line 20:
 
:Invalid hash type: '''Error: Not a valid hash type.'''
 
:Invalid hash type: '''Error: Not a valid hash type.'''
 
:Not all parameters are set: '''Error: Both a 'hash' and 'type' need to be defined.'''
 
: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 [http://insomnia247.nl/?page=chat 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.

Revision as of 16:07, 27 March 2011

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.