Difference between revisions of "Hashdb api"

From Insomnia 24/7 Wiki
Jump to: navigation, search
imported>Wikiadmin
imported>Wikiadmin
m
Line 11: Line 11:
 
So for example '''http://insomnia247.nl/hash_api.php?type=md5&hash=5f4dcc3b5aa765d61d8327deb882cf99''' would return '''password'''.
 
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.
+
No HTML or styling info is added. Just the blank, plain text password is returned.
  
  
 
==What comes back if something is wrong?==
 
==What comes back if something is wrong?==
:When a hash is not in the databse: '''Hash not found.'''
+
:When a hash is not in the database: '''Hash not found.'''
 
:Invalid MD5 hash: '''Error: Not a valid MD5 hash.'''
 
:Invalid MD5 hash: '''Error: Not a valid MD5 hash.'''
 
:Invalid SHA-1 hash: '''Error: Not a valid SHA-1 hash.'''
 
:Invalid SHA-1 hash: '''Error: Not a valid SHA-1 hash.'''
Line 23: Line 23:
  
 
==Some special chars show up weird==
 
==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:
+
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" />
 
:<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  
Line 31: Line 31:
  
  
==I plan to use it in a pretty big site/application. How much requests can I make?==
+
==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 [http://insomnia247.nl/?page=chat contact us].
 
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.
 
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 11:28, 7 June 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, 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.