退还算法订单授权数量
接口描述
退还指定订单的部分或全部授权数量,退还的金额将返回到账户余额。
请求说明
接口ID |
协议 |
方法 |
PATH |
47 |
HTTPS |
POST |
/openapi/v1/alg/orders/:order_no/return |
PATH参数
参数 |
类型 |
必填 |
说明 |
order_no |
string |
是 |
订单号 |
URL参数
参数 |
类型 |
必填 |
说明 |
accesskey_id |
string |
是 |
参见签名认证 |
expires |
int |
是 |
参见签名认证 |
signature |
string |
是 |
参见签名认证 |
HTTP请求头
字段 |
值 |
Content-Type |
application/json |
请求参数
请求参数以Json格式放置于Body中,如下:
参数 |
类型 |
必填 |
说明 |
count |
int |
是 |
退还数量 |
请求示例
POST https://open.vzicloud.com/openapi/v1/alg/orders/ORD20210618001/return?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Length: 16
Content-Type: application/json
{ "count": 2 }
返回说明
返回参数
参数 |
类型 |
说明 |
no |
string |
订单号 |
count |
int |
购买数量 |
return_count |
int |
已退还数量 |
total_price |
int |
订单总价(分) |
product_id |
int |
商品ID |
product_name |
string |
商品名称 |
product_brief |
string |
商品简介 |
product_price |
int |
商品单价(分) |
product_remark |
string |
商品备注 |
product_image_url |
string |
商品图片URL |
product_firmware_version |
string |
固件版本 |
product_period_time |
int |
授权时长 (0表示永久) |
product_period_unit |
int |
时长单位(0:小时,1:天,2:月,3:年,4:分钟) |
product_series_name |
string |
设备系列名称 |
buy_user_id |
int |
购买用户ID |
buy_accesskey_id |
string |
购买时使用的访问密钥ID |
remark |
string |
备注 |
create_time |
string |
订单创建时间 |
update_time |
string |
订单更新时间 |
注:返回参数里可能还包含其他信息但未在上面的表格内列出,请勿使用!
返回示例
{
"no": "ORD20210618001",
"count": 5,
"return_count": 2,
"total_price": 50000,
"product_id": 1,
"product_name": "人脸识别算法包",
"product_brief": "高精度人脸识别算法",
"product_price": 10000,
"product_remark": "支持多角度人脸识别",
"product_image_url": "https://example.com/image.jpg",
"product_firmware_version": "1.0.0",
"product_period_time": 30,
"product_period_unit": 1,
"product_series_name": "IPC系列",
"buy_user_id": 1001,
"buy_accesskey_id": "8d9EsDAD2115Q5PM8tuP6g1IdAglkayp",
"remark": "",
"create_time": "2021-06-18 11:44:03.575794",
"update_time": "2021-06-18 11:44:03.575794"
}