Open-Agent-Api
  1. 商品
Open-Agent-Api
  • 授权
    • 获取AccessToken
      POST
    • 刷新AccessToken
      POST
  • 商品
    • 4.1 获取商品标识列表
      GET
    • 4.2 获取商品信息
      GET
    • 4.3 获取商品详情
      GET
    • 4.4 获取商品图片
      GET
    • 4.5 获取商品上下架状态
      GET
    • 4.6 商品可售区域查询
      GET
    • 4.7 获取商品可配送区域
      GET
    • 4.8 商品可选配送时间查询
      GET
    • 4.9 商品附属信息查询
      GET
  • 地址
    • 5.1 获取省市区列表
      GET
  • 价格
    • 6.1 获取商品价格
      GET
  • 库存
    • 7.1 获取商品库存
      GET
  • 订单
    • 8.1 订单创建
      POST
    • 8.2 订单确认
      POST
    • 8.3 取消订单
      POST
    • 8.4 订单查询
      GET
    • 8.5 出库单查询
      GET
    • 8.6 包裹单查询
      GET
  • 售后
    • 9.1 售后单申请
      POST
    • 9.2 获取可申请售后商品
      GET
    • 9.3 获取售后单
      GET
    • 9.4 获取出库单所属售后单列表
      GET
    • 9.5 取消售后单
      POST
    • 9.6 获取售后包裹单明细
      GET
  • 物流
    • 10.2 获取运费规则
    • 10.1 获取物流日志
  • 发票
    • 12.1 发票申请
    • 12.2 发票查询
  • 类目
    • 13.1 获取大类列表
    • 13.2 获取中类列表
    • 13.3 获取小类列表
  • 员工
    • 1.1 创建用户
    • 1.3 处理用户变更
  1. 商品

4.9 商品附属信息查询

GET
/api/v2/product/extra
Product
获取商品在指定区域的附属信息

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数
product_id
string 
商品编号
必需
>= 0 字符<= 11 字符
示例值:
P0000001608
province
string 
省
必需
>= 0 字符<= 20 字符
示例值:
广东省
city
string 
市
必需
>= 0 字符<= 20 字符
示例值:
深圳市
county
string 
区
必需
>= 0 字符<= 20 字符
示例值:
南山区
Header 参数
channel
string 
可选
默认值:
benlai
shopId
string 
商城id
可选
默认值:
123

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://open-agent-branch.benlai.com/api/v2/product/extra?product_id=P0000001608&province=广东省&city=深圳市&county=南山区' \
--header 'channel: benlai' \
--header 'shopId: 123'

返回响应

🟢200成功
text/plain
Success
Body
product_id
string 
商品id
可选
presale
boolean 
是否预售
可选
presale_tips
string 
预售商品提示信息
可选
origin_shipment
boolean 
产地发货
可选
delivery_parttern
enum<string> 
配送方式
可选
ROOM_TEMPERATURE:常温配
COLD:冷链配
枚举值:
ROOM_TEMPERATURECOLD
示例值:
NOT_NOREASON_RETURN
return_policy
enum<string> 
退货条款类型
可选
None 无
NOT_NOREASON_RETURN 不支持7天无理由退货
YES_NOREASON_RETURN 支持7天无理由退货
枚举值:
None NOT_NOREASON_RETURNYES_NOREASON_RETURN
示例值:
NOT_NOREASON_RETURN
qc_images
array[object (Benlai.Open.Models.Product.ImageModuleDto) {2}] 
质检报告图
可选
title
string 
模块标题
可选
images
array[object (Benlai.Open.Models.Product.ReportImageDto) {2}] 
图片信息
可选
示例
{
    "code": 0,
    "msg": "",
    "value": {
        "product_id": "P0000034765",
        "presale": false,
        "presale_tips": "",
        "origin_shipment": false,
        "delivery_parttern": "COLD",
        "return_policy": "NOT_NOREASON_RETURN",
        "qc_images": [
            {
                "title": "报告1",
                "images": [
                    {
                        "thumbnail": "https://image3.benlailife.com/6f1310f1-61bb-4f8f-8977-6c51110dfe88",
                        "url": "https://image3.benlailife.com/6f1310f1-61bb-4f8f-8977-6c51110dfe88"
                    }
                ]
            },
            {
                "title": "报告2",
                "images": [
                    {
                        "thumbnail": "https://image1.benlailife.com/77e66b69-d378-4b9e-9f31-8cb08490ccff",
                        "url": "https://image1.benlailife.com/77e66b69-d378-4b9e-9f31-8cb08490ccff"
                    },
                    {
                        "thumbnail": "https://image1.benlailife.com/7db43df6-890f-446f-b46a-f3b155fff4f1",
                        "url": "https://image1.benlailife.com/7db43df6-890f-446f-b46a-f3b155fff4f1"
                    },
                    {
                        "thumbnail": "https://image1.benlailife.com/f5ee3397-cf5f-4b33-b813-b09ebffd11c1",
                        "url": "https://image1.benlailife.com/f5ee3397-cf5f-4b33-b813-b09ebffd11c1"
                    }
                ]
            },
            {
                "title": "报告3",
                "images": [
                    {
                        "thumbnail": "https://image1.benlailife.com/77e66b69-d378-4b9e-9f31-8cb08490ccff",
                        "url": "https://image1.benlailife.com/77e66b69-d378-4b9e-9f31-8cb08490ccff"
                    },
                    {
                        "thumbnail": "https://image1.benlailife.com/0e1859aa-27bb-4051-9a0e-4c3ca735d1c9",
                        "url": "https://image1.benlailife.com/0e1859aa-27bb-4051-9a0e-4c3ca735d1c9"
                    },
                    {
                        "thumbnail": "https://image.benlailife.com/1d610f13-3e8e-4821-83fb-c1b660c1106b",
                        "url": "https://image.benlailife.com/1d610f13-3e8e-4821-83fb-c1b660c1106b"
                    }
                ]
            }
        ]
    }
}
上一页
4.8 商品可选配送时间查询
下一页
5.1 获取省市区列表
Built with