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.'''
 +
 +
 +
==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 in your head tag section:
 +
:<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  
  

Revision as of 16:35, 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.


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 in your head tag section:

<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 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.