友朋运营商开放平台
  1. API 列表
友朋运营商开放平台
  • 友朋运营商平台第三方开放平台接口文档
  • 业务场景
    • 场景:自取柜第三方支付业务逻辑
    • 场景:异步通知第三方业务回调地址
    • 场景:自取柜售货机订单同步给第三方
  • API 列表
    • api.test
      POST
    • cabinet.list
      POST
    • cabinet.product.stock
      POST
    • cabinet.open.door
      POST
    • cabinet.order.refund.apply
      POST
    • cabinet.order.user.appeal
      POST
    • cabinet.order.list
      POST
    • cabinet.order.get
      POST
    • consumer.order.list
      POST
    • consumer.order.get
      POST
  1. API 列表

cabinet.product.stock

POST
https://api.yopoint.com/api/gateway/index
使用场景:
根据设备id(cid)查询机器当前的商品详情。

请求参数

Header 参数
Content-Type
string 
必需
默认值:
application/x-www-form-urlencoded
Body 参数multipart/form-data
appid
string 
必需
示例值:
{{appid}}
method
string 
必需
示例值:
cabinet.product.stock
biz_content
string 
CID即设备ID
必需
示例值:
{"CID":"65210ef35c5b0100113e61dd"}
version
string 
必需
示例值:
1.0.0
timestamp
string 
必需
示例值:
{% mock 'timestamp', 's' %}
sign_type
string 
必需
示例值:
md5

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.yopoint.com/api/gateway/index' \
--form 'appid=""' \
--form 'method="cabinet.product.stock"' \
--form 'biz_content="{\"CID\":\"65210ef35c5b0100113e61dd\"}"' \
--form 'version="1.0.0"' \
--form 'timestamp="{% mock '\''timestamp'\'', '\''s'\'' %}"' \
--form 'sign_type="md5"'

返回响应

🟢200成功
application/json
Body
error_code
integer 
必需
0代表成功,-1代表签名错误
error_msg
string 
必需
sub_error_code
null 
必需
sub_error_msg
null 
必需
data
array [object {9}] 
必需
OID
string 
运营商ID
必需
BarCode
string 
商品条码
必需
Price
integer 
商品金额
必需
单位:分
Stock
integer 
补货后库存
必需
最后一次补货的库存
Capacity
integer 
商品容积
必需
由运营商自定义
RemainStock
integer 
剩余库存
必需
当前库存
SalesCount
integer 
售卖数量
必需
Name
string 
商品名称
必需
ImageUrl
string 
商品图片地址
必需
示例
{"error_code":0,"error_msg":"SUCCESS","sub_error_code":null,"sub_error_msg":null,"data":[{"OID":"5e6b52d1b427cd001094a32a","BarCode":"9556570105139","Price":100,"Stock":0,"Capacity":0,"RemainStock":0,"SalesCount":0,"Name":"100 PLUS 325ML","ImageUrl":"https://res.yopoint.com/resource/20231016/51b019218856ef90abe0ac67ad8ccb75.png"},{"OID":"5e6b52d1b427cd001094a32a","BarCode":"9555589212142","Price":200,"Stock":0,"Capacity":0,"RemainStock":0,"SalesCount":0,"Name":"Coca-cola 320ml","ImageUrl":"https://res.yopoint.com/operators/20231016/3c9d4f0c3f1328c1e278b91f0519686b.png"},{"OID":"5e6b52d1b427cd001094a32a","BarCode":"8801056143015","Price":1,"Stock":0,"Capacity":0,"RemainStock":0,"SalesCount":0,"Name":"乐天七星柠檬味碳酸饮料","ImageUrl":"https://res.yopoint.com/resource/20220406/31d3ebc415f39d3839c95d6c0dd73e04.png"},{"OID":"5e6b52d1b427cd001094a32a","BarCode":"6973890880011","Price":100,"Stock":0,"Capacity":0,"RemainStock":0,"SalesCount":0,"Name":"十点一刻无糖气泡酒白桃乌龙味330ml","ImageUrl":"https://res.yopoint.com/resource/20220708/86e2d0801726f169fbe299b3e3f2728a.png"},{"OID":"5e6b52d1b427cd001094a32a","BarCode":"12517426","Price":500,"Stock":0,"Capacity":0,"RemainStock":0,"SalesCount":0,"Name":"活力一天","ImageUrl":"https://res.yopoint.com/resource/20230118/547ff73d51ba2ecd92e2c7c7189c9c66.jpg"}]}
修改于 2024-02-29 02:52:44
上一页
cabinet.list
下一页
cabinet.open.door
Built with