Blockchains Notary Bot
Your Browser is to old. You must update to use this site
Tip: Secure your account with a Password
If someone gets access to your private link (browser history, bookmarks), he could access and modify your registry. So now that you have data in it, we think you'd better add a password !
You've got Mail !
From : [email protected]
To :
Please, Click the Link inside to finalize the Password Protection Process.
The subject of our email is : Finalize Password Protection
If you do not find it in your inbox, check your spam folder (although it should not ends there..)
Until you click the link, your account IS NOT password protected !
Request & Answer
You send POST or GET requests to https://notbot.me/api and obtain a JSON string in return
Credential
You will need your API key :
Errors
When an error occurs, the JSON returned contains the fields errorCode and errorDescription.
Functions
Functions are sent with the filed requestType
Here are the available functions :
certificateRequest
{
"requestType": {
"required":true,
"format":"string",
"desc":"Submit document data that will be added to your registry and included in the next blockchain notarization batch.",
"ex":"certificateRequest"
},
"data": { "required":true,
"ex": {
"h": { "required":true,
"format":"string(64)",
"desc":"hash SHA256 of the document",
"ex":"e4ed77dad82ee6542f3642e8d3861dcb7ce410d549d3504b79bd1664ff646682"
},
"tag":{ "required":false,
"format":"string(-255)",
"desc":"tag to organise data retrieval",
"ex":"Math, Marketing"
},
"oDesc": { "required":false,
"ex": { "n": { "required":true,
"format":"string(-100)",
"desc":"file name, used for display purposes",
"ex":"BitcoinbySatoshiN.-TraductionFR.pdf"
},
"t":{ "required":true,
"format":"string(-100)",
"desc":"file type, used for display purposes",
"ex":"application/pdf"
},
"s":{ "required":true,
"format":"string(-100)",
"desc":"file size in bytes, used for display purposes",
"ex":"441703"
}
}
}
}
}
}
Responses
Success example
{
"id": "282"
}
Error examples
{
"id": 0,
"errorCode": 3,
"errorDescription": "incomplete Desc Error"
}
{
"id": 0,
"errorCode": 3,
"errorDescription": "Hash Error"
}
{
"id": 0,
"errorCode": 13,
"errorDescription": "tag is too long"
}
Warning example
{
"id": "280",
"errorCode": 1,
"errorDescription": "Document fingerprint is already in the registry"
}
deleteCertificate
{
"requestType": {
"required":true,
"format":"string",
"desc":"Delete the certificate from NotBot database.",
"ex":"deleteCertificate"
},
"id": {
"required":true,
"format":"integer",
"desc":"NotBot document id, returned by requesType=getCertificate",
"ex":"123456"
}
}
Success example
{
"id": "281"
"status":"deleted";
}
Error example
{
"errorCode": 7,
"errorDescription": "not found"
}
getAllCertificates
{
"requestType": {
"required":true,
"format":"string",
"desc":"Returns every certificate of your account within pagination boundaries.",
"ex":"getAllCertificates"
},
"tag":{ "required":false,
"format":"string(-255)",
"desc":"tag to organise data retrieval",
"ex":"Math, Marketing"
},
"page":{ "required":false,
"format":"numeric",
"desc":"page number, default value: 1",
"ex":"15"
},
"limit":{ "required":false,
"format":"numeric",
"desc":"maximum of items returned, default value 100",
"ex":"3"
}
}
Success Exaample
{
"total": 51,
"rows": [
{
"id": "214",
"h": "e4ed77dad82ee6542f3642e8d3861dcb7ce410d549d3504b79bd1664ff646682",
"nxt": {
"Fo": "H(D+H(C+H(H(Fi+A)+B)))",
"A": "e4ed77dad82ee6542f3642e8d3861dcb7ce410d549d3504b79bd1664ff646682",
"B": "125a859f97d46ef2fe95c1b720b511db25df536d02273caba89e57b3bf860ce5",
"C": "b1cdbad7b3f7e0d23caae653c9d73d0a76b39733de9580a295fd0578b595b7d3",
"D": "3ffdfda6369bdd1156057332b04fa6f5de287fbe17f5313cb84c5577ebb750de",
"Message": "fd3b42385f64bd0e43b98cc52a6a62247c282fe8556f7d53c674a6a68ac185f6",
"TransactionId": "12959980361136132209",
"BlockDate": "2016-01-09 21:07:47",
"Confirmations": 259325
},
"btc": {
"Fo": "H(E+H(D+H(H(B+H(A+Fi))+C)))",
"A": "e4ed77dad82ee6542f3642e8d3861dcb7ce410d549d3504b79bd1664ff646682",
"B": "41f1450a0ee021b029c6c8ed3ba5c5bf84cd5abaaeb99c7597c360623ae38c98",
"C": "c5a29db67653f070e5a651641d979144b46b8f2850ee813b2d55719f4fea0496",
"D": "82d379ca92be33fddb805b4620f206db3aa24bcdf1597541c3ff636a4121f199",
"E": "de01b858f2f8666dbf44230d23d05f8e23f7269de3c70aa9f0805a5474250aa0",
"Message": "c478e6d45d11771459521913625787b54a283c83738a98b7adac75f30efdc2ac",
"TransactionId": "a105f3cdfcb662ef00b163a0119e8b4fa4acc1aa9250dbf95402a562dc5e064d",
"BlockDate": "2016-01-10 13:08:14",
"Confirmations": 650
},
"public": "https:\/\/notbot.me\/certificate\/214"
"tag": "Math, Marketing"
},
{
"id": "157",
"h": "ef3c8898c12c094de223bb75b50775d0750d5713987386133c7e3a7f794e3baf",
"nxt": {
"Fo": "H(C+H(B+H(Fi+A)))",
"A": "ef3c8898c12c094de223bb75b50775d0750d5713987386133c7e3a7f794e3baf",
"B": "91d6a8f6122251c165fc79d764477de76c6c0e1e09e00512b758fe404fd49bb0",
"C": "0ba24276e222f7297a46f84c8449fbd016eddc0aef035e39a43f01ac2f500df7",
"Message": "c4b74d6afc14234af17f0df93823bde7acf623e4c1c82c1c9622fce675a78598",
"TransactionId": "7585279105453876745",
"BlockDate": "2015-12-17 19:59:45",
"Confirmations": 276885
},
"btc": {
"Fo": "H(H(E+H(D+H(C+H(H(A+Fi)+B))))+F)",
"A": "39e25e49dc8ec2719d9b71041d3cc77ab08f0111efbf741ab009e9972e2fb549",
"B": "6e77fe5e73e9cf6f285e811d5b3be91525ee39b8fc54d6849a4c497870bce804",
"C": "509a30d7bf1c061b33efb6a93d48ec4f4a2ee47025971eaebc9da2ff6ccfe321",
"D": "e6b61a154f26583279e1049506a53909e3559882bd7127b099577d4a55988b72",
"E": "12a6ff3c807bde1c0fdf179545214927293dcde8168ae5eedc4bee8b0dc140a2",
"F": "5900e96c22a2e3c7b574dce992e137f248ff360568ddad8eee228d2bbc0b8d24",
"Message": "ab49ab5a7d5627e561bc0e53a596e1cfb18a9fff6fa8efe7665fa60fe6add8c2",
"TransactionId": "c9171db701af9fd65be43d09ca6916f066d5d13fbbc60de162e4b04cd1326377",
"BlockDate": "2015-12-24 19:10:10",
"Confirmations": 3286
},
"public": "https:\/\/notbot.me\/certificate\/157"
"tag": "MP3"
},
{
"id": "156",
"h": "39e25e49dc8ec2719d9b71041d3cc77ab08f0111efbf741ab009e9972e2fb549",
"nxt": {
"Fo": "H(C+H(H(A+Fi)+B))",
"A": "4070c3d24326e42b1cbf986d5d8be2ed6fcbcfcdd3469199dcb627fa86faa6d3",
"B": "a5aeea949341e29a5275bb86070b7061f0382ed188b58b5b1d2fecc110c53933",
"C": "0ba24276e222f7297a46f84c8449fbd016eddc0aef035e39a43f01ac2f500df7",
"Message": "c4b74d6afc14234af17f0df93823bde7acf623e4c1c82c1c9622fce675a78598",
"TransactionId": "7585279105453876745",
"BlockDate": "2015-12-17 19:59:45",
"Confirmations": 276885
},
"btc": {
"Fo": "H(H(E+H(D+H(C+H(H(Fi+A)+B))))+F)",
"A": "ef3c8898c12c094de223bb75b50775d0750d5713987386133c7e3a7f794e3baf",
"B": "6e77fe5e73e9cf6f285e811d5b3be91525ee39b8fc54d6849a4c497870bce804",
"C": "509a30d7bf1c061b33efb6a93d48ec4f4a2ee47025971eaebc9da2ff6ccfe321",
"D": "e6b61a154f26583279e1049506a53909e3559882bd7127b099577d4a55988b72",
"E": "12a6ff3c807bde1c0fdf179545214927293dcde8168ae5eedc4bee8b0dc140a2",
"F": "5900e96c22a2e3c7b574dce992e137f248ff360568ddad8eee228d2bbc0b8d24",
"Message": "ab49ab5a7d5627e561bc0e53a596e1cfb18a9fff6fa8efe7665fa60fe6add8c2",
"TransactionId": "c9171db701af9fd65be43d09ca6916f066d5d13fbbc60de162e4b04cd1326377",
"BlockDate": "2015-12-24 19:10:10",
"Confirmations": 3286
},
"public": "https:\/\/notbot.me\/certificate\/156"
"tag": "Video, Fun"
}
]
}
Error Example (out of range)
{
"errorCode": 7,
"errorDescription": "not found"
}
getCertificate
{
"requestType": {
"required":true,
"format":"string",
"desc":"Extract Notbot certificate data.",
"ex":"getCertificate"
},
"h": {
"required":true,
"format":"string(64)",
"desc":"hash SHA256 of the document",
"ex":"e4ed77dad82ee6542f3642e8d3861dcb7ce410d549d3504b79bd1664ff646682"
}
}
Success example (pending blockchain departure)
{
"id": "281",
"Fi": "z4ed77dad82ee6542f3642e8d3861dcb7ce410d549d3504b79bd1664ff646682",
"nxt": {},
"btc": {},
"public": "https:\/\/notbot.me\/certificate\/281",
"tag": "Math, Marketing"
}
Success example (NXT submitted but Bitcoin pending departure)
{
"id": "181",
"h": "980ca5523dc5a2d022b17b6e33d8d762bbfcd0229b0e3c64a183b39670946933",
"nxt": {
"Message": "980ca5523dc5a2d022b17b6e33d8d762bbfcd0229b0e3c64a183b39670946933",
"TransactionId": "1413478271000673785",
"BlockDate": "2017-04-30 16:50:06",
"Confirmations": 17
},
"btc": {},
"public": "https:\/\/notbot.me\/certificate\/705"
"tag": "MP3"
}
Success Example (NXT & bitcoin transaction submited and confirmed)
{
"id": "214",
"h": "980ca5523dc5a2d022b17b6e33d8d762bbfcd0229b0e3c64a183b39670946933",
"nxt": {
"Message": "980ca5523dc5a2d022b17b6e33d8d762bbfcd0229b0e3c64a183b39670946933",
"TransactionId": "1413478271000673785",
"BlockDate": "2017-04-30 16:50:06",
"Confirmations": 17316
},
"btc": {
"Fo": "H(H(Fi+A)+B)",
"A": "8e55a9a2994e0b50370cac7d1457dcae8a858a33fc9638d39dfb1db684af2b43",
"B": "15632f3da7779fe9cfe7ec3fc1c8188dea9080e6f5b165b7363985c304845498",
"Message": "c7d31dddad22304da45a269b570d90e5e6dc8f2be8ca376cd2224e10a50c060d",
"TransactionId": "6b6c6a90490509f8f474e8dbb1c4c4eb86112c63f72271530e4eddde92fd9170",
"BlockDate": "2017-05-01 16:22:23",
"Confirmations": 1690
},
"public": "https:\/\/notbot.me\/certificate\/705"
"tag": "Legal Action"
}
Fi is the document hash (fingerprint)
if Fo (formula) is given, one must apply the formula to re-compute the message submited to the blockchain.
In the formula, H represents the SHA256 function. Without Fo, Message = Fi.
Error example (hash not found)
{
"errorCode": 7,
"errorDescription": "not found"
}
setTag
{
"requestType": {
"required":true,
"format":"string",
"desc":"set tag list of a certificate",
"ex":"setTag"
},
"id": {
"required":true,
"format":"integer",
"desc":"NotBot document id, returned by requesType=getCertificate",
"ex":"123456"
},
"tag": {
"required":true,
"format":"string(-255)",
"desc":"tag",
"ex":"copyright music, mp3"
}
}
Success example
{
"id": "151"
"tag":"copyright music, mp3";
}
Error examples
{
"errorCode": 11,
"errorDescription": "empty id"
}
{
"errorCode": 12,
"errorDescription": "empty tag"
}
{
"errorCode": 13,
"errorDescription": "tag is too long"
}
