Hashdb api - Revision history

Admin: /* How do I use it? */

2019-09-12T00:31:15Z

How do I use it?

← Older revision		Revision as of 00:31, 12 September 2019
Line 11:		Line 11:

	Example:		Example:
	~~<pre>~~https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd~~</pre>~~		https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd

	will return:		will return:
Line 29:		Line 29:
	This will also return the hashes for you;		This will also return the hashes for you;
	{"md5":"5e9d11a14ad1c8dd77e98ef9b53fd1ba","sha1":"f2c57870308dc87f432e5912d4de6f8e322721ba","sha256":"089542505d659cecbb988bb5ccff5bccf85be2dfa8c221359079aee2531298bb","password":"newpassword"}		{"md5":"5e9d11a14ad1c8dd77e98ef9b53fd1ba","sha1":"f2c57870308dc87f432e5912d4de6f8e322721ba","sha256":"089542505d659cecbb988bb5ccff5bccf85be2dfa8c221359079aee2531298bb","password":"newpassword"}


	==What comes back if something is wrong?==		==What comes back if something is wrong?==

imported>Wikiadmin at 17:58, 20 December 2017

2017-12-20T17:58:38Z

← Older revision		Revision as of 17:58, 20 December 2017
Line 8:		Line 8:
	==How do I use it?==		==How do I use it?==
	=== Looking up hashes ===		=== Looking up hashes ===
	You send an HTTP request to ~~<pre>~~https://hashdb.insomnia247.nl/v1/[hashfunction]/[passwordhash~~]<pre>~~.		You send an HTTP request to https://hashdb.insomnia247.nl/v1/hashfunction/passwordhash.

	Example:		Example:

imported>Wikiadmin at 17:57, 20 December 2017

2017-12-20T17:57:25Z

← Older revision		Revision as of 17:57, 20 December 2017
Line 8:		Line 8:
	==How do I use it?==		==How do I use it?==
	=== Looking up hashes ===		=== Looking up hashes ===
	You send an HTTP request to ~~'''~~https://hashdb.insomnia247.nl/v1/hashfunction/~~hash'''~~.		You send an HTTP request to <pre>https://hashdb.insomnia247.nl/v1/[hashfunction]/[passwordhash]<pre>.

	Example:		Example:
	<pre>https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd</pre>		<pre>https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd</pre>

			will return:

	{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}		{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}
Line 36:		Line 38:
	:Something terribly wrong: HTTP 500 Error. Please inform us if this happens.		:Something terribly wrong: HTTP 500 Error. Please inform us if this happens.

	~~:Known issue: HTTP 403 Error (Forbidden). When this happens, copy/paste the URL in a new tab.~~

	===PUT requests===		===PUT requests===

imported>Wikiadmin at 17:55, 20 December 2017

2017-12-20T17:55:19Z

← Older revision		Revision as of 17:55, 20 December 2017
Line 7:		Line 7:

	==How do I use it?==		==How do I use it?==
			=== Looking up hashes ===
	You send an HTTP request to '''https://hashdb.insomnia247.nl/v1/hashfunction/hash'''.		You send an HTTP request to '''https://hashdb.insomnia247.nl/v1/hashfunction/hash'''.

	~~So for example '''~~https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd~~''' will return '''~~{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}~~'''.~~		Example:
			<pre>https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd</pre>

			{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}

	Currently the '''md5''', '''sha1''', and '''sha256''' hashing algorithms are supported.		Currently the '''md5''', '''sha1''', and '''sha256''' hashing algorithms are supported.

	The results are always JSON encoded. You will always receive the ''hash'', ''found'', and ''result'' parameters in your response. The ''hash'' parameter is the hash you submitted, the ''found'' parameter will be ''true'' if the hash was found in the database or ''false'' if it was not. The final ''result'' parameter will contain the password if one has been found or ''null'' if no password has been found.		The results are always JSON encoded. You will always receive the ''hash'', ''found'', and ''result'' parameters in your response. The ''hash'' parameter is the hash you submitted, the ''found'' parameter will be ''true'' if the hash was found in the database or ''false'' if it was not. The final ''result'' parameter will contain the password if one has been found or ''null'' if no password has been found.

			=== Inserting new passwords ===
			If you find a hash that is not in the database but you know the password for, you can add to our database by inserting the new password. The ''/v1/insert'' endpoint accepts a '''PUT''' request with the '''password''' option.

			Example:
			<pre>curl -XPUT 'https://hashdb.insomnia247.nl/v1/insert' -d 'password=newpassword'</pre>

			This will also return the hashes for you;
			{"md5":"5e9d11a14ad1c8dd77e98ef9b53fd1ba","sha1":"f2c57870308dc87f432e5912d4de6f8e322721ba","sha256":"089542505d659cecbb988bb5ccff5bccf85be2dfa8c221359079aee2531298bb","password":"newpassword"}


	==What comes back if something is wrong?==		==What comes back if something is wrong?==
			===GET requests===
	:When a hash is not in the database: '''{"hash":"0123456789abdef0123456789abcdef0","found":false,"result":null}'''		:When a hash is not in the database: '''{"hash":"0123456789abdef0123456789abcdef0","found":false,"result":null}'''
	:Invalid hashing algorithm: HTTP 404 Error.		:Invalid hashing algorithm: HTTP 404 Error.
	:Invalid hash: HTTP 400 Error.		:Invalid hash: HTTP 400 Error.
	:Something terribly wrong: HTTP 500 Error. Please inform us if this happens.		:Something terribly wrong: HTTP 500 Error. Please inform us if this happens.

			:Known issue: HTTP 403 Error (Forbidden). When this happens, copy/paste the URL in a new tab.

			===PUT requests===
			:When the '''password''' option is not set: HTTP 400 Error.
			:When the wrong HTTP verb is used (ie. not PUT): HTTP 404 Error.

imported>Wikiadmin at 15:29, 18 December 2017

2017-12-18T15:29:08Z

← Older revision		Revision as of 15:29, 18 December 2017
Line 10:		Line 10:

	So for example '''https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd''' will return '''{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}'''.		So for example '''https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd''' will return '''{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}'''.

			Currently the '''md5''', '''sha1''', and '''sha256''' hashing algorithms are supported.

	The results are always JSON encoded. You will always receive the ''hash'', ''found'', and ''result'' parameters in your response. The ''hash'' parameter is the hash you submitted, the ''found'' parameter will be ''true'' if the hash was found in the database or ''false'' if it was not. The final ''result'' parameter will contain the password if one has been found or ''null'' if no password has been found.		The results are always JSON encoded. You will always receive the ''hash'', ''found'', and ''result'' parameters in your response. The ''hash'' parameter is the hash you submitted, the ''found'' parameter will be ''true'' if the hash was found in the database or ''false'' if it was not. The final ''result'' parameter will contain the password if one has been found or ''null'' if no password has been found.


	==What comes back if something is wrong?==		==What comes back if something is wrong?==

imported>Wikiadmin: /* How do I use it? */

2017-12-18T15:25:06Z

How do I use it?

← Older revision		Revision as of 15:25, 18 December 2017
Line 7:		Line 7:

	==How do I use it?==		==How do I use it?==
	You send an HTTP request to ''https://hashdb.insomnia247.nl/v1/[hashfunction]/[hash]''.		You send an HTTP request to '''https://hashdb.insomnia247.nl/v1/hashfunction/hash'''.

	So for example '''https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd''' will return '''{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}'''.		So for example '''https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd''' will return '''{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}'''.

imported>Wikiadmin: /* How do I use it? */

2017-12-18T15:23:56Z

How do I use it?

← Older revision		Revision as of 15:23, 18 December 2017
Line 7:		Line 7:

	==How do I use it?==		==How do I use it?==
	You send an HTTP request to https://hashdb.insomnia247.nl/v1/''[hashfunction]''/''[hash]''.		You send an HTTP request to ''https://hashdb.insomnia247.nl/v1/[hashfunction]/[hash]''.

	So for example '''https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd''' will return '''{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}'''.		So for example '''https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd''' will return '''{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}'''.

	The results are always JSON encoded. You will always receive the ''hash'', ''found'', and ''result'' parameters in your response. The ''hash'' parameter is the hash you submitted, the ''found'' parameter will be ''true'' if the hash was found in the database or ''false'' if it was not. The final ''result'' parameter will contain the password if one has been found or ''null'' if no password has been found.		The results are always JSON encoded. You will always receive the ''hash'', ''found'', and ''result'' parameters in your response. The ''hash'' parameter is the hash you submitted, the ''found'' parameter will be ''true'' if the hash was found in the database or ''false'' if it was not. The final ''result'' parameter will contain the password if one has been found or ''null'' if no password has been found.


	==What comes back if something is wrong?==		==What comes back if something is wrong?==

imported>Wikiadmin at 15:23, 18 December 2017

2017-12-18T15:23:11Z

← Older revision		Revision as of 15:23, 18 December 2017
Line 7:		Line 7:

	==How do I use it?==		==How do I use it?==
	You send an HTTP request to ~~http~~://insomnia247.nl/~~hash_api.php with the GET parameters~~ ''~~type~~'' ~~and~~ ''hash''.		You send an HTTP request to https://hashdb.insomnia247.nl/v1/''[hashfunction]''/''[hash]''.

	So for example '''~~http~~://insomnia247.nl/~~hash_api.php?type=~~md5~~&hash=~~de038c8d3a8e15b0c8578280ac12cffd''' ~~would~~ return ~~the password~~ '''ex499er4+!on$'''.		So for example '''https://hashdb.insomnia247.nl/v1/md5/de038c8d3a8e15b0c8578280ac12cffd''' will return '''{"hash":"de038c8d3a8e15b0c8578280ac12cffd","found":true,"result":"ex499er4+!on$"}'''.

	~~No HTML~~ or ~~styling info is added~~. ~~Just~~ the ~~blank, plain text~~ password ~~is returned~~.		The results are always JSON encoded. You will always receive the ''hash'', ''found'', and ''result'' parameters in your response. The ''hash'' parameter is the hash you submitted, the ''found'' parameter will be ''true'' if the hash was found in the database or ''false'' if it was not. The final ''result'' parameter will contain the password if one has been found or ''null'' if no password has been found.


	==What comes back if something is wrong?==		==What comes back if something is wrong?==
	:When a hash is not in the database: '''~~Hash not~~ found~~.'''~~		:When a hash is not in the database: '''{"hash":"0123456789abdef0123456789abcdef0","found":false,"result":null}'''
	:~~Invalid MD5 hash~~: ~~'''Error: Not a valid MD5 hash.~~'''		:Invalid hashing algorithm: HTTP 404 Error.
	:Invalid ~~SHA-1 hash~~: ~~'''~~Error~~: Not a valid SHA-1 hash~~.~~'''~~		:Invalid hash: HTTP 400 Error.
	:Invalid hash ~~type~~: ~~'''~~Error~~: Not a valid hash type~~.~~'''~~		:Something terribly wrong: HTTP 500 Error. Please inform us if this happens.
	:~~Not all parameters are set~~: ~~'''~~Error~~: Both a 'hash' and 'type' need to be defined~~.~~'''~~

imported>Wikiadmin at 20:08, 8 October 2015

2015-10-08T20:08:30Z

← Older revision		Revision as of 20:08, 8 October 2015
Line 9:		Line 9:
	You send an HTTP request to http://insomnia247.nl/hash_api.php with the GET parameters ''type'' and ''hash''.		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~~'''.		So for example '''http://insomnia247.nl/hash_api.php?type=md5&hash=de038c8d3a8e15b0c8578280ac12cffd''' would return the password '''ex499er4+!on$'''.

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

imported>Wikiadmin at 11:28, 7 June 2011

2011-06-07T11:28:09Z

← Older revision		Revision as of 11:28, 7 June 2011
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.