Store and review
1.上传图片
/custodyAccount/store/UploadingStoreImage
请求e.g
curl --location 'http://localhost:8081/custodyAccount/store/UploadingStoreImage' --header 'Authorization: ••••••' --form 'file=@"/C:/Users/Desktop/backgrou.png"'
返回值:
{
"success": true,
"error": "",
"code": 200,
"data": "https://cdn.file.microlinktoken.com/CustodyStoreImages/2_20250519160734.jpg"
}
2.商家账户申请
2.1 申请新的商家
/custodyAccount/store/ApplyNewStore
请求体:
{"store_info":"{\"npubkey\":\"testusr11\",\"storeType\":\"a\",\"assetId\":\"dc073ca924754b50257de9569f4f6a0ce7c9026720eb5c52f42afab5aab8ad0e\",\"assetName\":\"we\",\"feeRate\":0.00,\"area\":\"exampleArea\",\"address\":\"exampleAddress\",\"name\":\"exampleName\",\"scope\":\"exampleScope\",\"linkName\":\"exampleLinkName\",\"linkPhone\":\"1111111\",\"proposer\":\"exampleProposer\",\"proposerPhone\":\"1111111\",\"proposeTime\":\"exampleProposeTime\",\"imageStoreFront\":\"exampleImageStoreFront\",\"imageCashierDesk\":\"exampleImageCashierDesk\",\"imagePanorama\":\"exampleImagePanorama\"}"}
store_info类型为字符串,是一个json字符串,格式如下
{
"npubkey": "testusr11",//商家npubkey
"storeType": "a",//商家类型 a or b
"assetId": "dc073ca924754b50257de9569f4f6a0ce7c9026720eb5c52f42afab5aab8ad0e",//商家资产id
"assetName": "we",//商家资产名
"feeRate": 0,//资产汇率
"area": "exampleArea",//商家区域
"address": "exampleAddress",//商家详细地址
"name": "exampleName",//商家名
"scope": "exampleScope",//商家经营范围
"linkName": "exampleLinkName",//商家联系人姓名
"linkPhone": "1111111",//商家联系方式
"proposer": "exampleProposer",//填报人姓名
"proposerPhone": "1111111",//填报人联系方式
"proposeTime": "exampleProposeTime",//填报时间
"imageStoreFront": "exampleImageStoreFront",//门头照片url
"imageCashierDesk": "exampleImageCashierDesk",//收银照片url
"imagePanorama": "exampleImagePanorama"//全景照片
}
返回值
{
"success": true,
"error": "",
"code": 200,
"data": {
"success": "success"
}
}
2.2查看申请历史
/custodyAccount/store/ListNewStoreProposes
请求体无:
响应体:
{
"success": true,
"error": "",
"code": 200,
"data": [
{
"ID": 7,//审批id
"CreatedAt": "2025-05-19T14:44:46.07+08:00",
"UpdatedAt": "2025-05-19T14:45:20.958+08:00",
"DeletedAt": null,
"UserId": 2,//申请人userid
"Type": "createStore"//审批类型
"Data": "{\"area\": \"exampleArea\", \"name\": \"exampleName\", \"scope\": \"exampleScope\", \"address\": \"exampleAddress\", \"assetId\": \"dc073ca924754b50257de9569f4f6a0ce7c9026720eb5c52f42afab5aab8ad0e\", \"feeRate\": 0, \"npubkey\": \"testusr11\", \"linkName\": \"exampleLinkName\", \"proposer\": \"exampleProposer\", \"assetName\": \"we\", \"linkPhone\": \"1111111\", \"storeType\": \"A\", \"proposeTime\": \"exampleProposeTime\", \"imagePanorama\": \"exampleImagePanorama\", \"proposerPhone\": \"1111111\", \"imageStoreFront\": \"exampleImageStoreFront\", \"imageCashierDesk\": \"exampleImageCashierDesk\"}",
"Memo": "ssss",//审批备注,可以在改变审批状态时更改
"Status": 1 //审批状态:0待审批,1通过,2.不通过
},
{
"ID": 5
"CreatedAt": "2025-05-16T11:45:39.569+08:00",
"UpdatedAt": "2025-05-16T11:45:39.569+08:00",
"DeletedAt": null,
"UserId": 2,
"Type": "createStore",
"Data": "{\"area\": \"exampleArea\", \"name\": \"exampleName\", \"scope\": \"exampleScope\", \"address\": \"exampleAddress\", \"assetId\": \"dc073ca924754b50257de9569f4f6a0ce7c9026720eb5c52f42afab5aab8ad0e\", \"feeRate\": 0, \"npubkey\": \"store1\", \"linkName\": \"exampleLinkName\", \"proposer\": \"exampleProposer\", \"assetName\": \"we\", \"linkPhone\": \"1111111\", \"storeType\": \"A\", \"proposeTime\": \"exampleProposeTime\", \"imagePanorama\": \"exampleImagePanorama\", \"proposerPhone\": \"1111111\", \"imageStoreFront\": \"exampleImageStoreFront\", \"imageCashierDesk\": \"exampleImageCashierDesk\"}",
"Memo": "",
"Status": 0
}
]
}
data中字段即位2.1中传入的json字符串
3评论相关
3.1获取一个交易的详细信息
/custodyAccount/store/GetOrderInfo
请求体:
{
"order_id": "ef2aad87344a0e4d7e50d2d8a259daaddb39319b778b75c6c54d8bc4f61633ae"
}
order_id;即交易hsah
响应体:
{
"success": true,
"error": "",
"code": 200,
"data": {
"customerNpubkey": "testusr", //用户
"time": "2025-05-09 12:10:08",
"assetName": "abt2413311523",//资产名称
"amount": 110,
"storeNpubkey": "testusr11",//商家
"storeName": "we"//商家名
"storeAddress": "exampleAddress”//商家地址
}
}
3.2发布评论
/custodyAccount/store/ApplyReview
请求体:
{
"review": "{\"orderId\":\"a647c9b76227a106399217e4cdc072688d4c6c5a3b18ba4d97428d91ffd363e6\",\"product\":\"test\",\"orderImage\":\"test\",\"wechatImage\":\"test\",\"review\":\"testrebiew\"}"
}
review为字符串,其中为json字符串,格式
{
"orderId": "a647c9b76227a106399217e4cdc072688d4c6c5a3b18ba4d97428d91ffd363e6",//交易hash
"product": "test",//商品名
"orderImage": "test",//订单照片url
"wechatImage": "test",//朋友圈照片url
"review": "testrebiew"//文字评论
}
返回值:
{
"success": true,
"error": "",
"code": 200,
"data": {
"success": "success"
}
}
3.3查询评论历史
/custodyAccount/store/ListApplyReviewProposes
无请求体
响应体
{
"success": true,
"error": "",
"code": 200,
"data": [
{
"ID": 9,
"CreatedAt": "2025-05-19T14:51:30.314+08:00",
"UpdatedAt": "2025-05-19T14:51:30.314+08:00",
"DeletedAt": null,
"UserId": 2,
"Type": "reviewAward",
"Data": "{\"review\": \"testrebiew\", \"orderId\": \"a647c9b76227a106399217e4cdc072688d4c6c5a3b18ba4d97428d91ffd363e6\", \"product\": \"test\", \"orderImage\": \"test\", \"wechatImage\": \"test\"}",
"Memo": "",
"Status": 0
},
{
"ID": 8,
"CreatedAt": "2025-05-19T14:45:58.805+08:00",
"UpdatedAt": "2025-05-19T14:45:58.805+08:00",
"DeletedAt": null,
"UserId": 2,
"Type": "reviewAward",
"Data": "{\"review\": \"testrebiew\", \"orderId\": \"ef2aad87344a0e4d7e50d2d8a259daaddb39319b778b75c6c54d8bc4f61633ae\", \"product\": \"test\", \"orderImage\": \"test\", \"wechatImage\": \"test\"}",
"Memo": "",
"Status": 0
},
{
"ID": 6,
"CreatedAt": "2025-05-19T14:29:34.747+08:00",
"UpdatedAt": "2025-05-19T14:29:34.747+08:00",
"DeletedAt": null,
"UserId": 2,
"Type": "reviewAward",
"Data": "{\"review\": \"testrebiew\", \"orderId\": \"ptns7b2250617941737365744964223a2233666234343131396139393431373264336564663632356563633231656435393664386339306336383139666133343330373038653731646435353039333036222c22506179416d6f756e74223a3131302c225265636569766541737365744964223a2264633037336361393234373534623530323537646539353639663466366130636537633930323637323065623563353266343261666162356161623861643065222c2252656365697665416d6f756e74223a35342c2254696d65223a313734363736333830372c225461726765744e7075624b6579223a22746573747573723131222c22566973696f6e223a307d\", \"product\": \"test\", \"orderImage\": \"test\", \"wechatImage\": \"test\"}",
"Memo": "",
"Status": 0
}
]
}
Data格式同3.2
Last updated