Asch storage服务接口

0 通用错误处理

每一个接口都返回json数据
每个响应都包含success字段，表示请求是否成功，成功为true, 失败为false
如果失败，则还会包含一个error字段，表示错误原因

{
    "success": false,
    "error": "Invalide content encode type"
}

1 上传数据

请求

路径 /api/storages
方法 put
格式 json
说明 上传数据

参数列表

特别说明 wait为0表示不等待，速度最快，但无法保证数据在掉电情况下不丢失，大于2时，可以100%确保数据已经同步到大部分机器上了，但需要时间较长10-20秒之间，折中的方案是1,wait为1时虽然不能100%保证同步到其他机器，但失败的几率非常小，只是理论上存在，实际上还没遇到过

示例

curl -k -H "Content-Type: application/json" -X PUT -d '{"secret":"mirror napkin recycle parent rough point arctic suspect film cage orchard spot","content":"aGVsbG93b3JsZA==","encode":"base64","wait":1}' http://10.1.238.16:6666/api/storages

响应

{
    "success": true,
    "transactionId": "12642332469631378771"
}

2 查询数据

请求

路径 /api/storages/get
方法 get
格式 urlencode
说明 获取数据

参数列表

示例

curl http://10.1.238.16:6666/api/storages/get?id=12642332469631378771

响应

{
    "success": true,
    "id": "12642332469631378771",  // 交易id
    "height": "43",  // 交易所在区块高度
    "blockId": "1610713892747510166",   // 交易所在区块id
    "type": 8,  // 交易类型
    "timestamp": 11470937,  // 交易时间，举例创世块的offset
    "senderPublicKey": "8e2916ec9bf9807fdac2d0f0263a02be587a49f45ab0ce7fa50b3a7b01a3af9d",  // 上传者公钥
    "senderId": "8329974131975904225",  // 上传者id
    "recipientId": "",  // 可忽略
    "amount": 0,  // 可忽略
    "fee": 10000000,  // 交易费
    "signature": "4129d535c8f041e9ea6721ab1ecc91bb965756612494c6264cb75016ec2757de72a540f48623dd6aa403f97b53f5e7bd6a7e790905a6947e58fd82b25d4ceb03",  // 交易签名
    "signSignature": "",  // 二级签名，有二级密码时才有
    "signatures": null,  // 多重签名，使用多重签名账户时才有
    "confirmations": "3",  // 交易确认数
    "asset": {
        "storage": {
            "content": "68656c6c6f776f726c64"  // 数据内容，16进制字符串
        }
    }
}