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