Name: Hashing API | MD5, SHA and BLAKE2b Hash Generator
Brand: zsmartsoft
SKU: api-zsmartsoft-hashing-api
Availability: InStock
Author: API Market

Ezzat Elbadrawy

# Hashing API

## API Overview

Hash Text/File/Bytes Using one of the following Algorithms:

-  **MD5** : Message-Digest Algorithm (16-byte)
-  **SHA** (1/256/384/512) : Secure Hash Algorithm (1: 20-byte, 256: 32-byte, 384: 48-byte, 512: 64-byte)
-  **Blake2B** : It's a cryptographic hash function based on Dan Bernstein's ChaCha stream cipher (64-byte). Blake2B hashing has optional key paramter to make your private hashing.


If hashing process completed successfully repsonse will be a JSON object with 3 props like this:
`{ "result":"Success", "hashHexString":"...............", "hashBase64String":"............" }`

But if failed the repsonse will be a JSON object with 1 prop like this:
`{ "result":"Failure: error-message" }`


### MD5 Text Hash (GET API)

Hash text (query-paramter) using MD5 algorithm.
Query Params:

1. dataString : (Required) Text which you want to hash.

**Example :**

```
REQUEST

curl --request GET \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/md5/hashtext?dataString=myText123 \
	--header 'x-api-market-key: YOUR-KEY' \
```

```
RESPONSE 200 OK

{"hashHexString":"e21b455105bf39ffd2c22b5692a26068", "hashBase64String":"4htFUQW/Of/SwitWkqJgaA==", "result":"Success"}
```


### MD5 Text Hash (POST API)

Hash text (post-body) using MD5 algorithm.

Request post-body is a JSON object contains 1 prop:

1. dataString : (Required) Text which you want to hash.

`{"dataString": "enter-your-string-here"}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/md5/hashtext \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"dataString":"myText123"}'	
```

```
RESPONSE 200 OK

{"hashHexString":"e21b455105bf39ffd2c22b5692a26068", "hashBase64String":"4htFUQW/Of/SwitWkqJgaA==", "result":"Success"}

```

### MD5 File Hash (POST API)

Hash file (post-body) using MD5 algorithm.

Request post-body will contains the file as multipart/form-data.

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/md5/hashfile \
	--header 'Content-Type: multipart/form-data' \
	--header 'x-api-market-key: YOUR-KEY' \
	--form file=myTestFile.pdf
```

```
RESPONSE 200 OK

{"hashHexString":"89174c3284f9f3ad673d1f2c1949aa8f", "hashBase64String":"iRdMMoT5861nPR8sGUmqjw==", "result":"Success"}
```


### MD5 Bytes Hash (POST API)

Hash array of bytes (post-body) using MD5 algorithm.

Request post-body is a JSON object contains 1 prop:

1. data : (Required) Array of bytes which you want to hash.

`{"data":[]}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/md5/hashbytes \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8]}'	
```

```
RESPONSE 200 OK

{"hashHexString":"a64175b16028f447d774b6608089d282", "hashBase64String":"pkF1sWAo9EfXdLZggInSgg==", "result":"Success"}
```


### MD5 Buffer Hash (POST API)

Hash specified bytes from posted array using MD5 algorithm.

Request post-body is a JSON object contains 3 prop:

1. data : (Required) Array of bytes which you want to hash.
2. start : (Required) Index of start byte in data-array.
3. count : (Required) Count of bytes to hash.

`{"data": [], "start":0, "count":0}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/md5/hashbuffer \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8],"start":1,"count":2}'
```
	

```
RESPONSE 200 OK

{"hashHexString":"9d154d4d2d99ffa0308a0de4ab0c1a9a", "hashBase64String":"nRVNTS2Z/6Awig3kqwwamg==", "result":"Success"}
```


### SHA Text Hash (GET API)

Hash text (query-paramter) using SHA algorithm (1, 256 (default), 384 or 512).
Query Params:

1. dataString : (Required) Text which you want to hash.
2. mode : (Required) SHA Number (1, 256, 384 or 512).

**Example :**

```
REQUEST

curl --request GET \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/sha/256/hashtext?dataString=myText123 \
	--header 'x-api-market-key: YOUR-KEY' \
```

```
RESPONSE 200 OK

{"hashHexString":"4ebed7983794e9a540175dddf40a6c7bed537e838e820e9f2761f4b945f087e8", "hashBase64String":"Tr7XmDeU6aVAF13d9Apse+1TfoOOgg6fJ2H0uUXwh+g=", "result":"Success"}
```


### SHA Text Hash (POST API)

Hash text (post-body) using SHA algorithm (1, 256 (default), 384 or 512).
Query Params:

1. mode : (Required) SHA Number (1, 256, 384 or 512).

Request post-body is a JSON object contains 1 prop:

1. dataString : (Required) Text which you want to hash.

`{"dataString": "enter-your-string-here"}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/sha/256/hashtext \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"dataString":"myText123"}'
```
	

```
RESPONSE 200 OK

{"hashHexString":"4ebed7983794e9a540175dddf40a6c7bed537e838e820e9f2761f4b945f087e8", "hashBase64String":"Tr7XmDeU6aVAF13d9Apse+1TfoOOgg6fJ2H0uUXwh+g=", "result":"Success"}
```


### SHA File Hash (POST API)

Hash file (post-body) using SHA algorithm (1, 256 (default), 384 or 512).
Query Params:

1. mode : (Required) SHA Number (1, 256, 384 or 512).

Request post-body will contains the file as multipart/form-data.

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/sha/256/hashfile \
	--header 'Content-Type: multipart/form-data' \
	--header 'x-api-market-key: YOUR-KEY' \
	--form file=myTestFile.pdf
```

```
RESPONSE 200 OK

{"hashHexString":"e20df7cc9939edbbe085c158c6287637fead59e1e101de1e14de859eee63d714", "hashBase64String":"4g33zJk57bvghcFYxih2N/6tWeHhAd4eFN6Fnu5j1xQ=", "result":"Success"}
```


### SHA Bytes Hash (POST API)

Hash array of bytes (post-body) using SHA algorithm (1, 256 (default), 384 or 512).
Query Params:

1. mode : (Required) SHA Number (1, 256, 384 or 512).

Request post-body is a JSON object contains 1 prop:

1. data : (Required) Array of bytes which you want to hash.

`{"data":[]}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/sha/256/hashbytes \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8]}'	
```

```
RESPONSE 200 OK

{"hashHexString":"3ec1ffe3440cfbee2b4af33e1906a21e6a3dc9943966637e34bbf0c9357581e6", "hashBase64String":"PsH/40QM++4rSvM+GQaiHmo9yZQ5ZmN+NLvwyTV1geY=", "result":"Success"}
```


### SHA Buffer Hash (POST API)

Hash specified bytes from posted array using SHA algorithm (1, 256 (default), 384 or 512).
Query Params:

1. mode : (Required) SHA Number (1, 256, 384 or 512).

Request post-body is a JSON object contains 3 prop:

1. data : (Required) Array of bytes which you want to hash.
2. start : (Required) Index of start byte in data-array.
3. count : (Required) Count of bytes to hash.

`{"data":[], "start":0, "count":0}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/sha/256/hashbuffer \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8],"start":1,"count":2}'
```
	

```
RESPONSE 200 OK

{"hashHexString":"7e0a7d4ea9096f702ce7656bf2437ea11767ba8503821615fcc1bdc268cbdf64", "hashBase64String":"fgp9TqkJb3As52Vr8kN+oRdnuoUDghYV/MG9wmjL32Q=", "result":"Success"}
```


### Blake2B Text Hash (GET API)

Hash text (query-paramter) using Blake2B algorithm.
Query Params:

1. dataString : (Required) Text which you want to hash.

**Example :**

```
REQUEST

curl --request GET \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashtext?dataString=myText123 \
	--header 'x-api-market-key: YOUR-KEY' \
```

```
RESPONSE 200 OK

{"hashHexString":"1c580382806dc68aae7d524d9ae1b0fc689bd5a0dce2e5673ed56fee124a9745cec7e4e001701ca06781cf89d6d5f5e1faf8427b1a1bab450008ce5972d6f180", "hashBase64String":"HFgDgoBtxoqufVJNmuGw/Gib1aDc4uVnPtVv7hJKl0XOx+TgAXAcoGeBz4nW1fXh+vhCexobq0UACM5ZctbxgA==", "result":"Success"}
```


### Blake2B Text Hash (POST API)

Hash text (post-body) using Blake2B algorithm.

Request post-body is a JSON object contains 1 prop:

1. dataString : (Required) Text which you want to hash.

`{"dataString":"enter-your-string-here"}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashtext \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"dataString":"myText123"}'
```
	

```
RESPONSE 200 OK

{"hashHexString":"1c580382806dc68aae7d524d9ae1b0fc689bd5a0dce2e5673ed56fee124a9745cec7e4e001701ca06781cf89d6d5f5e1faf8427b1a1bab450008ce5972d6f180", "hashBase64String":"HFgDgoBtxoqufVJNmuGw/Gib1aDc4uVnPtVv7hJKl0XOx+TgAXAcoGeBz4nW1fXh+vhCexobq0UACM5ZctbxgA==", "result":"Success"}
```


### Blake2B Text Hash With Key (GET API)

Hash text (query-paramter) using Blake2B algorithm with private key-string (query-paramter).
Query Params:

1. dataString : (Required) Text which you want to hash.
2. keyString : (Required) Blake2B private key.

**Example :**

```
REQUEST

curl --request GET \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashtextusingkey?dataString=myText123&keyString=myKey123 \
	--header 'x-api-market-key: YOUR-KEY' \
```

```
RESPONSE 200 OK

{"hashHexString":"36d888718034db7ac46d88c84e3604377cb31fd3e8e1f4cf1a7574fe4f38eae39db9716b9b076379fb376276f51a47f6e596b7287fdfd753f71c6390b3bad47a", "hashBase64String":"NtiIcYA023rEbYjITjYEN3yzH9Po4fTPGnV0/k846uOduXFrmwdjefs3Ynb1Gkf25Za3KH/f11P3HGOQs7rUeg==", "result":"Success"}
```


### Blake2B Text Hash (POST API)

Hash text (post-body) using Blake2B algorithm with private key-string (query-paramter).
Query Params:

1. keyString : (Required) Blake2B private key.

Request post-body is a JSON object contains 1 prop:

1. dataString : (Required) Text which you want to hash.

`{"dataString":"enter-your-string-here"}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashtextusingkey?keyString=myKey123 \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"dataString":"myText123"}'
```
	

```
RESPONSE 200 OK

{"hashHexString":"36d888718034db7ac46d88c84e3604377cb31fd3e8e1f4cf1a7574fe4f38eae39db9716b9b076379fb376276f51a47f6e596b7287fdfd753f71c6390b3bad47a", "hashBase64String":"NtiIcYA023rEbYjITjYEN3yzH9Po4fTPGnV0/k846uOduXFrmwdjefs3Ynb1Gkf25Za3KH/f11P3HGOQs7rUeg==", "result":"Success"}
```


### Blake2B Text Hash 2 (POST API)

Hash text (post-body) using Blake2B algorithm with private key-string (post-body).

Request post-body is a JSON object contains 2 prop:

1. dataString : (Required) Text which you want to hash.
2. keyString : (Required) Blake2B private key.

`{"dataString":"enter-your-string-here", "keyString":"enter-your-key-here"}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashtextusingkey2 \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"dataString":"myText123", "keyString":"myKey123"}'
```
	

```
RESPONSE 200 OK

{"hashHexString":"36d888718034db7ac46d88c84e3604377cb31fd3e8e1f4cf1a7574fe4f38eae39db9716b9b076379fb376276f51a47f6e596b7287fdfd753f71c6390b3bad47a", "hashBase64String":"NtiIcYA023rEbYjITjYEN3yzH9Po4fTPGnV0/k846uOduXFrmwdjefs3Ynb1Gkf25Za3KH/f11P3HGOQs7rUeg==", "result":"Success"}
```


### Blake2B File Hash (POST API)

Hash file (post-body) using Blake2B algorithm.

Request post-body will contains the file as multipart/form-data.

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashfile \
	--header 'Content-Type: multipart/form-data' \
	--header 'x-api-market-key: YOUR-KEY' \
	--form file=myTestFile.pdf
```

```
RESPONSE 200 OK

{"hashHexString":"656ed806bae2363b4e2c35b9d2e84991e95088b913aeb7b5bf5103a66f29b8b4d0679a707e1eb5099e08ed4401fce1f346c753cc2057c6239834b27db0c17a1f", "hashBase64String":"ZW7YBrriNjtOLDW50uhJkelQiLkTrre1v1EDpm8puLTQZ5pwfh61CZ4I7UQB/OHzRsdTzCBXxiOYNLJ9sMF6Hw==", "result":"Success"}
```


### Blake2B File Hash With Key (POST API)

Hash file (post-body) using Blake2B algorithm with private key-string (query-paramter).
Query Params:

1. keyString : (Required) Blake2B private key.

Request post-body will contains the file as multipart/form-data.

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashfilewithkey?keyString=myKey123 \
	--header 'Content-Type: multipart/form-data' \
	--header 'x-api-market-key: YOUR-KEY' \
	--form file=myTestFile.pdf
```

```
RESPONSE 200 OK

{"hashHexString":"ff10d17d1da2375e7cc3c167d9c0984eaddad09d993c81d9b2f7e689fc666dbce3c7d96fa02f71776651d4dbcd458a57845bf2ca99c4ebe44687279d57a4738f", "hashBase64String":"/xDRfR2iN158w8Fn2cCYTq3a0J2ZPIHZsvfmifxmbbzjx9lvoC9xd2ZR1NvNRYpXhFvyypnE6+RGhyedV6Rzjw==", "result":"Success"}
```


### Blake2B Bytes Hash (POST API)

Hash array of bytes (post-body) using Blake2B algorithm.

Request post-body is a JSON object contains 1 prop:

1. data : (Required) Array of bytes which you want to hash.

`{"data":[]}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashbytes \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8]}'	
```

```
RESPONSE 200 OK

{"hashHexString":"17123fedd3c146927652ae1443cbb6caa7fda3d2bf0f98b102333d454f2e7b1e09750bf62d15499e40d546d3dbd815c23cbd43b2e30fc431f4a0b3bd792caa31", "hashBase64String":"FxI/7dPBRpJ2Uq4UQ8u2yqf9o9K/D5ixAjM9RU8uex4JdQv2LRVJnkDVRtPb2BXCPL1DsuMPxDH0oLO9eSyqMQ==", "result":"Success"}
```


### Blake2B Bytes Hash With Key (POST API)

Hash array of bytes (post-body) using Blake2B algorithm with private key-bytes (post-body).

Request post-body is a JSON object contains 2 prop:

1. data : (Required) Array of bytes which you want to hash.
2. key : (Required) Array of byte for private key.

`{"data":[], "key":[]}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashbytesrwithkey \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8], "key":[99,55,66]}'	
```

```
RESPONSE 200 OK

{"hashHexString":"0e3977b0c988a5d5a3f215978aac6c2f07f25cca70b990be596b3d95c99549b396240138f10529c0cb50943ddcb862caab6644d9efcc100fc3da040e7e1eada9", "hashBase64String":"Djl3sMmIpdWj8hWXiqxsLwfyXMpwuZC+WWs9lcmVSbOWJAE48QUpwMtQlD3cuGLKq2ZE2e/MEA/D2gQOfh6tqQ==", "result":"Success"}
```


### Blake2B Buffer Hash (POST API)

Hash specified bytes from posted array using Blake2B algorithm.

Request post-body is a JSON object contains 3 prop:

1. data : (Required) Array of bytes which you want to hash.
2. start : (Required) Index of start byte in data-array.
3. count : (Required) Count of bytes to hash.

`{"data":[], "start":0, "count":0}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashbuffer \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8],"start":1,"count":2}'
```
	

```
RESPONSE 200 OK

{"hashHexString":"e263f5872ab7f04d7af73dfb17a8d49a5d9eda87e80c8f597c85d35891f600d5b3bdd89621bbdf1d654d0bfd4ce47b2bc3443b557a962af419067622b28c8290", "hashBase64String":"4mP1hyq38E169z37F6jUml2e2ofoDI9ZfIXTWJH2ANWzvdiWIbvfHWVNC/1M5Hsrw0Q7VXqWKvQZBnYisoyCkA==", "result":"Success"}
```


### Blake2B Buffer Hash With Key (POST API)

Hash specified bytes from posted array using Blake2B algorithm with private key-string (query-paramter).
Query Params:

    keyString : (Required) Blake2B private key.

Request post-body is a JSON object contains 3 prop:

1. data : (Required) Array of bytes which you want to hash.
2. start : (Required) Index of start byte in data-array.
3. count : (Required) Count of bytes to hash.

`{"data":[], "start":0, "count":0}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashbufferwithkey?keyString=myKey123 \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8],"start":1,"count":2}'
```
	

```
RESPONSE 200 OK

{"hashHexString":"e85e9a459757a47786687c48f1327a144b952e0b33abe6301171ec188d4600581faa2beec55f2ee33ee10ab70ece46129992803e7a7dd43c780592c44dc3f302", "hashBase64String":"6F6aRZdXpHeGaHxI8TJ6FEuVLgszq+YwEXHsGI1GAFgfqivuxV8u4z7hCrcOzkYSmZKAPnp91Dx4BZLETcPzAg==", "result":"Success"}
```


### Blake2B Buffer Hash With Key 2 (POST API)

Hash specified bytes from posted array using Blake2B algorithm with private key-bytes (post-body).

Request post-body is a JSON object contains 4 prop:
1. data : (Required) Array of bytes which you want to hash.
2. start : (Required) Index of start byte in data-array.
3. count : (Required) Count of bytes to hash.
4. key : (Required) Array of byte for private key. 

`{"data":[], "start":0, "count":0, "key":[]}`

**Example :**

```
REQUEST

curl --request POST \
	--url https://prod.api.market/api/v1/zsmartsoft/hashing-api/api/blake2b/hashbufferwithkey2 \
	--header 'Content-Type: application/json' \
	--header 'x-api-market-key: YOUR-KEY' \
	--data {"data":[105,216,70,8],"start":1,"count":2, "key":[99,55,66]}'	
```

```
RESPONSE 200 OK

{"hashHexString":"847fbf1a745198d44efa604c89facc5766ab2c06093400c27b2a3f325b2be118b22bc8e01c37b54592e66300f13f6a05f4116456220d76bc158828a52229ad46", "hashBase64String":"hH+/GnRRmNRO+mBMifrMV2arLAYJNADCeyo/Mlsr4RiyK8jgHDe1RZLmYwDxP2oF9BFkViINdrwViCilIimtRg==", "result":"Success"}
```

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Hash text, files and bytes with MD5, SHA-1/256/384/512 or BLAKE2b (with an optional key). Hex and Base64 output through one REST API.