抖音
  1. 商品库接入
抖音
  • 简介
  • 签名算法
  • 接口调用凭证
    • 经营能力调用凭证
      • BusinessToken 生成
      • BusinessToken 刷新
      • 经营能力当前状态查询
    • 非用户授权调用凭证
      • 获取应用授权调用凭证
      • getAccessToken
    • 用户授权调用凭证
      • 获取用户授权调用凭证
      • 刷新用户授权调用凭证
      • 刷新授权调用凭证
  • 登录
    • code2Session
  • 小程序码与小程序链接
    • Schema 链接
      • 生成SchemaV2
      • 查询SchemaV2
      • 查询Schema配额V2
    • Link链接
      • 生成 Link V2
      • 查询 Link 配额V2
      • 查询 Link V2
    • 二维码
      • 生成QRCodeV2
  • 私域经营
    • 私信管理
      • IM主动授权webhook
      • 主动发送私信
    • 群聊管理
      • 粉丝群webhook
        • 用户加群申请 webhook
        • 用户加群webhook
      • 查询群信息
      • 设置进群问候语&群公告
      • 创建粉丝群
      • 取消进群问候语&群公告配置
      • 变更用户入群申请状态
      • 查询用户剩余建群额度
      • 查询群主所在群的用户入群申请状态
    • 经营工具
      • 小程序引导卡片
        • 创建/更新小程序引导卡片模板
        • 查询小程序引导卡片模板
        • 删除小程序引导卡片模板
      • 图片上传
  • 线索组建
    • 创建线索组件
    • 查询已创建的线索组件
    • 更新线索组件
    • 删除线索组件
  • 视频能力
    • 视频数据查询
      • 查询特定视频的视频数据
    • 近 30 天用户视频数据
      • 获取视频基础数据
      • 获取视频点赞数据
      • 获取视频评论数据
      • 获取视频播放数据
      • 获取视频分享数据
    • 视频评论数据
      • 置顶评论
      • 评论回复列表
      • 评论列表
      • 回复视频评论
    • videoid转换itemid
    • itemid转换encryptid
  • 搜索能力
    • 创建抖音搜索直达子服务
    • 查询已创建的抖音搜索直达子服务列表
    • 删除抖音搜索直达子服务
    • 校验是否有搜索直达服务的创建权限
  • 电商
    • 注册小程序积分阈值
    • 注册小程序预览图
    • 查询订单的定制完成状态
    • 定制类小程序开发者注册信息
    • 退会
  • 生活服务
    • 店铺接入
      • 商铺同步
      • 查询店铺
      • 获取抖音POI ID
      • 店铺匹配任务结果查询
      • 店铺匹配状态查询
      • 提交门店匹配任务
      • 查询全部店铺信息接口(天级别请求5次)
      • 查询店铺全部信息任务返回内容
    • 商品库接入
      • (老版本)SKU同步
        POST
      • (老版本)sku拉取(该接口由接入方实现)
        GET
      • (老版本)多门店SPU同步
        POST
      • (老版本)多门店SPU状态同步
        POST
      • (老版本)多门店SPU库存同步
        POST
      • (老版本)多门店SPU信息查询
        GET
      • 创建/修改团购商品
        POST
      • 免审修改商品
        POST
      • 上下架商品
        POST
      • 同步库存
        POST
      • 查询商品模板
        GET
      • 查询商品草稿数据
        GET
      • 查询商品线上数据
        GET
      • 查询商品线上数据列表
        GET
      • 查询商品草稿数据列表
        GET
      • 用于创建多 SKU 商品。
        POST
      • 查询商品品类
        GET
    • 端内消息同步
      • 订单同步
    • poi数据接入
      • 获取POI基础数据
      • POI用户数据
      • POI服务基础数据
      • POI服务成交用户数据
      • POI热度榜
      • POI认领列表
    • poi基础能力
      • 通过高德POI ID获取抖音POI ID
    • 优惠卷接入
      • 优惠券同步
      • 优惠券更新
    • CPS佣金设置与查询
      • 通用佣金计划查询带货数据
      • 通用佣金计划查询达人带货数据
      • 通用佣金计划查询带货达人列表
      • 通用佣金计划查询达人带货详情
      • 查询通用佣金计划
      • 发布/修改通用佣金计划
      • 修改通用佣金计划状态
      • 发布/修改直播间定向佣金计划
      • 发布/修改短视频定向佣金计划
      • 修改定向佣金计划状态
      • 取消定向佣金计划指定的达人
      • 查询达人的定向佣金计划带货数据
      • 通过商品 ID 查询定向佣金计划
      • 查询定向佣金计划带货汇总数据
  • 用户信息
    • 用户抖音主页数据
      • 获取用户视频情况
      • 获取用户粉丝数
      • 获取用户点赞数
      • 获取用户评论数
      • 获取用户分享数
      • 获取用户主页访问数
  • 分享
    • 拍抖音任务
      • 拍抖音任务变更推送
      • 创建任务
      • 查询用户任务进度
    • 拍抖音互动任务
      • 拍抖音互动任务变更推送
      • 创建任务
      • 查询用户任务进度
    • 分享任务
      • 创建任务
      • 查询用户任务进度
  • 客服
    • CustomerServiceUrl
  • 小程序卷
    • 「小程序券」直播玩法接入指南
    • 小程序券API列表
    • 更新日志
    • 用户卷管理
      • 查询用户可用券信息
      • 用户领券结果回调通知
      • 用户撤销核销券
      • 用户手机号授权结果回调通知
      • 用户核销券
    • 主播授权管理
      • 查询主播发券配置信息
      • 修改主播发券权限状态
      • 更新主播发券库存上限
      • 主播发券权限配置
    • 卷模版管理
      • 查询授权用户发放的活动信息
      • 创建券模板
      • 修改券模板
      • 删除券模板
      • 修改券模板库存
      • 修改券模板状态
      • 查询券模板发放统计数据
      • 查询券模板
      • 查询对账单
    • 接口发放管理
      • 创建开发者接口发券活动
      • 开发者接口发券
      • 删除开发者接口发券活动
  • 交易系统
    • 通用交易系统
      • 通用参数
      • 进件
        • 接口进件
          • 图片上传
          • 发起进件
          • 进件查询
        • 获取进件页面链接
          • 开发者获取小程序收款商户/合作方进件页面
          • 服务商获取小程序收款商户进件页面
          • 服务商获取服务商进件页面
          • 服务商获取合作方进件页面
      • 标签
        • 查询标签组信息
      • 订单
        • 查询CPS信息
        • 查询订单信息
        • 支付结果回调
      • 退款
        • 发起退款
        • 查询退款
        • 同步退款审核结果
        • 退款申请回调扩展点
        • 退款结果通知
      • 履约
        • 推送履约状态
      • 结算
        • 发起分账
        • 查询分账
        • 通知分账结果
      • 提现
        • 接口提现
          • 商户余额查询
          • 商户提现
          • 商户提现结果查询
        • 获取提现页面链接
          • 开发者获取小程序收款商户/合作方提现页面
          • 服务商获取小程序收款商户提现页面
          • 服务商获取服务商提现页面
          • 服务商获取合作方提现页面
      • 获取对账单
        • 获取资金账单
        • 获取交易账单
    • 生活服务交易系统(金融合板)
      • 通用参数
      • 错误码和返回码
      • 查询接口
        • 查询订单信息
        • 查询券状态信息
        • 查询 CPS 信息
      • 预下单
        • 预下单扩展点
        • 开发者发起下单
      • 营销算价
        • 营销算价扩展点介绍
        • 查询营销算价扩展点
      • 支付
        • 支付结果通知
      • 核销
        • 抖音码
          • 验券准备
          • 验券
          • 撤销核销
          • 券码核销通知
          • 撤销核销通知
        • 三方码
          • 推送核销状态
          • 撤销核销
      • 分账
        • 查询分账
      • 退货退款
        • 开发者发起退款
        • 同步退款审核结果
        • 查询退款
        • 退款扩展点
        • 退款结果通知
    • 生活服务交易系统(账号融合版)
      • 错误码和返回码
      • 通用参数
      • 预约
        • 创建预约单
        • 预约接单结果回调
        • 商家取消预约
        • 用户取消预约
        • 查询预约单信息
        • 预约接单超时回调
        • 预约取消/完成通知
      • 查询接口
        • 查询订单信息
        • 查询券状态信息
        • 查询CPS信息
      • 预下单
        • 预下单回调
        • 关闭订单
        • 发起下单
      • 营销算价
        • 营销算价扩展点介绍
        • 查询营销信息扩展点
        • 算价扩展点
        • 营销查询算价二合一
      • 支付
        • 通知支付结果
      • 核销
        • 抖音码
          • 验券准备
          • 验券
        • 三方码
          • 推送核销状态
        • 核销工具
          • 查询用户券列表
          • 查询订单可用门店
          • 券核销消息通知
          • 撤销核销消息通知
          • 设置商家展示信息
          • 查询商家配置文案
          • 设置订单详情页按钮白名单接口
          • 设置小程序跳转path
      • 分账
        • 发起分账
        • 查询分账
        • 通知分账结果
      • 退货退款
        • 发起退款
        • 同步退款审核结果
        • 查询退款
        • 退款申请回调
        • 通知退款结果
    • 行业交易系统
      • API 调用
        • 通用参数
        • 错误码和返回码
      • 回调设置
        • 设置回调地址
        • 查询回调地址
      • 预下单
        • 查询 CPS 信息
        • 查询订单信息
        • 预下单回调
        • 开发者发起下单
      • 营销算价
        • 营销算价扩展点介绍
        • 查询营销信息扩展点
        • 设置扩展点
        • 算价扩展点
    • 支付
      • 通知支付结果
    • 核销
      • 抖音码
        • 验券准备
        • 验券
        • 查询劵状态信息
      • 三方码
        • 推送核销状态
      • 分账
        • 发起分账
        • 查询分账
        • 通知分账结果
    • 提货退款
      • 开发者发起退款
      • 同步退款审核结果
      • 查询退款
      • 退款申请回调
      • 通知退款结果
  • 内容安全
    • 内容安全检测
    • 图片检测V2
    • 图片检测V3
  • 泛知识
    • 角色系统
      • 错误码
      • 上传材料
      • 代运营服务商帮老师或代运营模式机构入驻
      • 自营机构/服务商入驻
      • 新增角色
      • 查询基础认证资质
      • 更新基础认证资质
      • 查询类目认证资质
      • 更新类目认证资质
      • 添加类目认证资质
      • 获取审核任务详情
      • 小程序绑定角色
      • 小程序解除绑定角色
      • 查询小程序已绑定的角色
      • 角色授权小程序
      • 解除授权小程序
      • 查询授权小程序
      • 更新授权小程序授权信息
      • 查询抖音号绑定、能力授权
      • 新增抖音号绑定、能力授权
      • 解除抖音号绑定、解除能力授权
      • 查询实体ID
      • 查询实体已绑定抖音号列表
    • 课程库
      • 【泛知识】回调通知
      • 【泛知识】课程库 FAQ
      • 【泛知识】错误码
      • 【泛知识】上传课程资源
      • 【泛知识】查询课程资源上传状态
      • 【泛知识】查询资质
      • 【泛知识】添加课程
      • 【泛知识】修改课程
      • 【泛知识】修改课程状态
      • 【泛知识】查询课程
      • 【泛知识】修改课程免审
      • 【泛知识】查询免审课程
      • 【泛知识】修改商品退款规则
      • 【泛知识】查询可选退款规则
      • 【泛知识】查询课程类目信息
  • 担任支付
    • 进件
      • 进件状态回调
      • 发起进件请求
      • 图片上传接口
      • 进件状态查询
    • 支付
      • 支付结果回调
      • 支付常见问题
      • 预下单接口
      • 唤起收银台
      • 支付结果查询
    • 退款
      • 退款结果回调
      • 退款常见问题
      • 发起退款
      • 退款结果查询
    • 结算及分账
      • 收费规则
      • 结算及分账常见问题
      • 自动结算
        • 自动结算接入说明
        • 自动结算结果回调
        • 自动结算结果查询
      • 发起结算及分账
      • 结算及分账结果查询
      • 结算及分账结果回调
      • 可分账余额查询
    • 退分账
      • 发起退分账
      • 查询分账回退结果
    • 提现
      • 商户余额查询
      • 商户提现
      • 商户提现结果查询
      • 商户提现回调
    • 获取对账单
      • 获取交易账单
      • 获取资金账单
    • 接口获取页面链接
      • 进件
        • 开发者获取小程序收款商户/合作方进件页面
        • 服务商获取小程序收款商户进件页面
        • 服务商获取服务商进件页面
        • 服务商获取合作方进件页面
      • 提取
        • 开发者获取小程序收款商户/合作方提现页面
        • 服务商获取小程序收款商户提现页面
        • 服务商获取服务商提现页面
        • 服务商获取合作方提现页面
    • 订单推送
      • 订单同步
  • 评价
    • 获取评价数据
  • 其他
    • 用户登录态签名
    • 抖音开放平台与小程序视频打通能力
      • 抖音开放平台与小程序视频打通能力
      • 视频使用能力能力
    • 开放能力配置接口
      • 开放能力配置接口
      • 配置开放能力实现接口
      • 查询生效中配置接口
    • 解决方案测试实体管理接口
      • 解决方案测试实体管理接口
      • 新增测试实体接口
      • 查询测试实体接口
      • 删除测试实体接口
    • 直播间自定义封面
    • 上传资源
    • 能力申请
    • 查询能力申请状态
  • 订阅消息
    • 查询订阅消息模版库
    • 发送订阅消息
    • 查询小程序的模版列表
    • 添加模板
    • 删除已添加的模版
    • 查询新建订阅消息模板列表
    • 新建订阅消息模板
  • 小程序推广计划
    • 短视频任务
      • 创建任务
        • 小程序任务台能力
        • 创建任务
      • 查询任务台任务投稿视频数据(明细)
      • 查询任务台任务投稿视频数据
      • 查询小程序任务台任务 ID
      • 更新任务状态
      • 重新提交任务基础信息
      • 查询任务详情
      • 更新专属任务达人
      • 查询视频任务相关实时汇总数据
    • 直播间任务
      • 创建直播间任务
      • 更新直播间任务
  • 挂载
    • 自主挂载
      • 获取作者视频列表
      • 自主挂载存量视频绑定锚点
      • 自主挂载存量视频解绑锚点
    • 小程序直播挂载黑白名单管理能力
    • 拍抖音黑白名单管理能力
    • 申请短视频自主挂载能力
    • 查询短视频自主挂载能力申请状态
    • 申请直播自主挂载能力
    • 查询直播自主挂载能力申请状态
    • 申请短视频达人推广挂载能力
    • 查询短视频达人推广挂载能力申请状态
    • 查询直播达人推广挂载能力申请状态
    • 申请直播达人推广挂载能力
    • 短视频/直播自主挂载能力绑定抖音号
    • 获取短视频/直播自主挂载抖音号绑定二维码
    • 查询短视频/直播自主挂载能力绑定抖音号列表
    • 解除短视频/直播自主挂载能力抖音号绑定
    • 挂载权限校验
    • 修改短视频锚点配置
    • 查询短视频锚点配置
    • 查询短视频锚点配置修改记录及状态
    • 图片上传
    • 图片审核状态查询
    • 图片删除
    • 设置全局默认配置
    • 设置指定页面配置
    • 查询全局默认配置
    • 查询指定页面配置
    • 删除指定页面配置
    • 讲解卡动态更新
  • 分发
    • 添加小程序别名
    • 查询小程序别名
    • 修改小程序别名
    • 删除小程序别名
    • 设置小程序搜索标签
    • 查询小程序搜索标签列表
  • 引导关注抖音号
    • 绑定抖音号
    • 获取抖音号绑定二维码
    • 获取绑定抖音号列表
    • 解除抖音号绑定
  • 数据分析
    • 用户分析
      • 行为分析
      • 实时分析
      • 留存分析
      • 来源分析
      • 用户画像
      • 终端分析
      • 页面分析
    • 交易分析
      • 总览分析
      • 流量转化
      • 短视频交易分析
      • 获取直播房间数据
      • 直播数据分析
      • 直播交易分析
      • 商品分析
    • 短视频分析
      • 短视频投稿数据
      • 短视频总览数据
      • 短视频详细数据
      • 流量来源
    • 直播分析
      • 直播间详细数据
        • 接口 1
        • 接口 2
      • 直播间总览数据
      • 主播分析
    • 小房子直播分析
      • 小房子直播间总览数据
      • 小房子直播间详细数据
      • 小房子直播间订单数据
    • 留资分析
      • 组件使用数据
      • 流量来源
      • 组件详细数据
      • 组件使用对比
  • 服务类目
    • 获取已设置的服务类目
  • 直播间能力
    • 查询跳转抖音直播间能力申请状态
    • 申请跳转抖音直播间能力
    • 查询直播间状态组件能力申请状态
    • 申请直播间状态组件能力
  • 抖音开放能力
    • 查询抖音开放能力列表
    • 申请开通抖音开放能力
    • 查询scope配额详情
    • scope申请提额
    • 查询视频关键词列表
    • 新增视频关键词
    • 删除视频关键词
  • 页面结构自定义
    • 查询页面结构自定义能力申请状态
    • 申请页面结构自定义能力
  • 普通二维码绑定
    • 查询普通二维码绑定列表
    • 新增绑定二维码
    • 更新绑定二维码链接
    • 更新绑定二维码状态
    • 删除绑定二维码链接
  • 抖音号绑定
    • 获取抖音号绑定所需的资质模版列表
    • 获取抖音号绑定所需的资质模版信息
    • 输入抖音号绑定
    • 获取抖音号绑定二维码
    • 查询抖音号绑定列表及状态
    • 解除抖音号绑定
  • 流量主
    • 查询流量主开通状态
    • 开通流量主
    • 查询广告位列表
    • 新增广告位
    • 更新广告位状态
    • 查询广告收入
    • 查询广告结算单列表
  • 抖店绑定
    • 绑定抖店开放平台账号
    • 查询绑定的抖店开放平台账号信息
    • 配置抖店开放平台应用
    • 查询配置的抖店开放平台应用信息
    • 获取绑定抖店账号信息
  1. 商品库接入

查询商品模板

开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
GET
/life/goods/template/get/
用于创建商品前查询商品模板。
查询商品模板,创建商品时的属性列表需与该接口保持一致,否则无法识别。
权限要求
需要权限申请,参考在开发者平台控制台选择行业类目及身份后的入驻指引。

枚举字典#

product_type#

1 : 团购套餐 3 : 预售券 4 : 日历房 5 : 门票 7 : 旅行跟拍 8 : 一日游 11 : 代金券

商品模板举例#

仅供参考,如与接口返回不一致,以接口返回为准
团购模板 (1 代表必填属性,2 代表选填属性)#
模板
1000000300000040000006000000700000080000001700000018000000
属性美食团购模板运动健身团购模板休闲娱乐团购模板生活服务团购模板教育培训团购模板住宿团购模板丽人团购模板游玩团购模板
appointment 预约信息11111111
auto_renew 自动延期11111111
bring_out_meal 是否可以外带餐食1
can_no_use_date 不可使用日期11111111
contains_insurance 是否包含保险1
customer_reserved_info 留资规则22222222
Description 商品描述1111111
description_rich_text 其他说明信息22222222
detail_image_list 长图22222222
dishes_image_list 菜品图2
EntryType 入口类型22222222
environment_image_list 环境图22222222
free_pack 是否可以打包1
FrontCategoryTag 前台品类标签22222222
holiday_additional_charge 节假日是否额外收费1
image_list 封面图11111111
IndustryType 商品行业类型22222222
IsConfirmImme 是否立即确认22222222
IsNeedPick 是否需要取票1
limit_gender 是否限制性别1
limit_hair_length 是否限制长短发1
original_vip_can_experience 商家原会员是否可以体验1
MpResourceID 小程序资源id22222222
MpSettleType 小程序分账类型22222222
NearestOrderTime 最早可订时间1
Notification 使用规则11111111
private_room 是否可以使用包间1
real_name_info 实名信息22222222
RecommendWord 推荐语22222222
rec_person_num 建议使用人数1
rec_person_num_max 最多使用人数1
RefundPolicy 退款政策11111111
refund_need_merchant_confirm 退款是否需商家审核11111111
show_channel 投放渠道11111111
SortWeight 排序权重22222222
superimposed_discounts 可以享受店内其他优惠1
TagList 标签列表22222222
trade_url 小程序提单页跳转22222222
use_date 使用日期11111111
use_time 使用时间11111111
code_source_type 券码生成方式11111111
commodity 菜品搭配1
market_price 市场价22222222
settle_type 收款方式11111111
use_type 团购使用方式11111111
limit_rule 限制购买11111111
SuitableGroup 适用人群1
TicketType 票种类型2
SubTitle 副标题22222222
日历房模板#
属性KEY属性名称是否列表是否必填描述
FrontCategoryTag前台品类标签TRUEFALSE["一日游","代金券","含房套餐","美食套餐","美食单品","门票","旅行跟拍","门店服务","单房型"]
can_no_use_date不可使用日期FALSEFALSE
use_time使用时间FALSEFALSE
Notification使用规则TRUEFALSE
description_rich_text其他说明信息TRUEFALSE
superimposed_discounts可以享受店内其他优惠FALSEFALSE
private_room是否可以使用包间FALSEFALSE
free_pack是否可以打包FALSEFALSE
bring_out_meal是否可以外带餐食FALSEFALSE
add_bed加床规则FALSEFALSE0-不可加床 1-收费 2-免费
add_bed_fee加床费用FALSEFALSE加床费用/每人,单位人民币分
BreakfastRule加早规则FALSEFALSE
need_charge_if_timeout超时是否收费FALSEFALSE
charge_rule收费规则FALSEFALSE
check_in_time入住时间FALSEFALSE
check_out_time退房时间FALSEFALSE
appointment预约信息FALSEFALSE
Area房间面积FALSEFALSE
BedName床型FALSEFALSE
breakfast早餐FALSEFALSE枚举:0-不含早 1-含早
image_list封面图TRUETRUE
detail_image_list长图TRUEFALSE
EntryType入口类型FALSEFALSE1-H5 2-小程序
Facility酒店设施TRUEFALSE
FitNum房间适住人数FALSEFALSE
smoke是否禁烟FALSEFALSE枚举:0-不禁烟 1-禁烟
SortWeight排序权重FALSEFALSE按降序排列
Floor楼层FALSEFALSE
Date日期FALSETRUE单sku的使用日期,同时代表了当前sku售价和库存的对应日期 value : "20220808"
sku_imageSku图片TRUEFALSE
limit_rule限制购买FALSEFALSE
RefundPolicy退款政策FALSEFALSE1-允许退款 2-不可退款 3-有条件退
refund_need_merchant_confirm退款是否需商家审核FALSEFALSEtrue-需要商家审核 false-无需审核
trade_url小程序提单页跳转FALSEFALSE
MpSettleType小程序分账类型FALSEFALSE1-包销 2-代销
RecommendWord推荐语FALSEFALSE
SubTitle副标题FALSEFALSE
commodity菜品搭配FALSETRUE
门票模板#
属性KEY属性名称是否列表是否必填描述
image_list封面图TRUETRUE
OrderDependsOnDate下单是否以依赖日期FALSEFALSE
IndustryType商品行业类型FALSEFALSE
EntryType入口类型FALSEFALSE1:H5 2:小程序 3:抖音 4:lynx
SortWeight排序权重FALSEFALSE
FrontCategoryTag前台品类标签TRUEFALSE
RefundPolicy退款政策FALSEFALSE1-允许退款 2-不可退款 3-有条件退
SuitableGroup适用人群TRUETRUE
holiday_additional_charge节假日是否额外收费FALSETRUE
contains_insurance是否包含保险FALSETRUE
NearestOrderTime最早可订时间FALSETRUE
IsNeedPick是否需要取票FALSETRUE
TicketType票种类型TRUEFALSE
EntryType入口类型FALSEFALSE1-H5 2-小程序
trade_url小程序提单页跳转FALSEFALSE
MpSettleType小程序分账类型FALSEFALSE1-包销 2-代销
IsConfirmImme是否立即确认FALSEFALSE
预售券#
AttrKeyAttrKeyName是否必填
FrontCategoryTag前台品类标签FALSE
RecommendWord推荐语FALSE
IndustryType商品行业类型FALSE
SuitableGroup适用人群FALSE
TicketType票种类型FALSE
EntryType入口类型FALSE
can_no_use_date不可使用日期FALSE
use_time使用时间FALSE
Notification使用规则FALSE
description_rich_text其他说明信息FALSE
superimposed_discounts可以享受店内其他优惠FALSE
private_room是否可以使用包间FALSE
free_pack是否可以打包FALSE
bring_out_meal是否可以外带餐食FALSE
add_bed加床规则FALSE
add_bed_fee加床费用FALSE
need_charge_if_timeout超时是否收费FALSE
charge_rule收费规则FALSE
check_in_time入住时间FALSE
check_out_time退房时间FALSE
limit_hair_length是否限制长短发FALSE
limit_gender是否限制性别FALSE
original_vip_can_experience商家原会员是否可以体验FALSE
holiday_additional_charge节假日是否额外收费FALSE
contains_insurance是否包含保险FALSE
appointment预约信息FALSE
RefundPolicy退款政策FALSE
refund_need_merchant_confirm退款是否需商家审核FALSE
image_list封面图FALSE
detail_image_list长图FALSE
limit_rule限制购买FALSE
trade_url小程序提单页跳转FALSE
MpSettleType小程序分账类型FALSE
一日游模板#
属性KEY属性名称是否列表是否必填描述
image_list封面图TRUETRUE
OrderDependsOnDate下单是否以依赖日期FALSEFALSE
IndustryType商品行业类型FALSEFALSE
EntryType入口类型FALSEFALSE1:H5 2:小程序 3:抖音 4:lynx
SortWeight排序权重FALSEFALSE
FrontCategoryTag前台品类标签TRUEFALSE
RefundPolicy退款政策FALSEFALSE1-允许退款 2-不可退款 3-有条件退
SuitableGroup适用人群TRUETRUE
holiday_additional_charge节假日是否额外收费FALSETRUE
contains_insurance是否包含保险FALSETRUE
NearestOrderTime最早可订时间FALSETRUE
IsNeedPick是否需要取票FALSETRUE
TicketType票种类型TRUEFALSE
EntryType入口类型FALSEFALSE1-H5 2-小程序
trade_url小程序提单页跳转FALSEFALSE
MpSettleType小程序分账类型FALSEFALSE1-包销 2-代销
IsConfirmImme是否立即确认FALSEFALSE
旅游跟拍模板#
属性KEY属性名称是否列表是否必填描述
image_list封面图TRUETRUE
OrderDependsOnDate下单是否以依赖日期FALSEFALSE
IndustryType商品行业类型FALSEFALSE
EntryType入口类型FALSEFALSE1:H5 2:小程序 3:抖音 4:lynx
SortWeight排序权重FALSEFALSE
FrontCategoryTag前台品类标签TRUEFALSE
RefundPolicy退款政策FALSEFALSE1-允许退款 2-不可退款 3-有条件退
SuitableGroup适用人群TRUETRUE
holiday_additional_charge节假日是否额外收费FALSETRUE
contains_insurance是否包含保险FALSETRUE
NearestOrderTime最早可订时间FALSETRUE
IsNeedPick是否需要取票FALSETRUE
TicketType票种类型TRUEFALSE
EntryType入口类型FALSEFALSE1-H5 2-小程序
trade_url小程序提单页跳转FALSEFALSE
MpSettleType小程序分账类型FALSEFALSE1-包销 2-代销
IsConfirmImme是否立即确认FALSEFALSE
代金券模板#
属性KEY属性名称是否列表是否必填描述
FrontCategoryTag前台品类标签TRUEFALSE
RecommendWord推荐语FALSEFALSE
IndustryType商品行业类型FALSEFALSE
EntryType入口类型FALSEFALSE
SortWeight排序权重FALSEFALSE
use_date使用日期FALSETRUE
can_no_use_date不可使用日期FALSETRUE
use_time使用时间FALSETRUE
Notification使用规则TRUETRUE
description_rich_text其他说明信息TRUEFALSE
superimposed_discounts可以享受店内其他优惠FALSETRUE
private_room是否可以使用包间FALSETRUE
free_pack是否可以打包FALSETRUE
bring_out_meal是否可以外带餐食FALSETRUE
rec_person_num建议使用人数FALSETRUE
rec_person_num_max最多使用人数FALSETRUE
need_deposit是否需要缴纳押金FALSETRUE
add_bed加床规则FALSETRUE
add_bed_fee加床费用FALSETRUE
need_charge_if_timeout超时是否收费FALSETRUE
charge_rule收费规则FALSETRUE
check_in_time入住时间FALSETRUE
check_out_time退房时间FALSETRUE
FitNum房间适住人数FALSETRUE
Area房间面积FALSETRUE
BedName床型FALSETRUE
breakfast早餐FALSETRUE
smoke是否禁烟FALSETRUE
Floor楼层FALSETRUE
View景色FALSETRUE
Window是否有窗FALSETRUE
Facility酒店设施TRUETRUE
limit_hair_length是否限制长短发FALSETRUE
limit_gender是否限制性别FALSETRUE
original_vip_can_experience商家原会员是否可以体验FALSETRUE
SuitableGroup适用人群TRUETRUE
holiday_additional_charge节假日是否额外收费FALSETRUE
contains_insurance是否包含保险FALSETRUE
NearestOrderTime最早可订时间FALSETRUE
IsNeedPick是否需要取票FALSETRUE
TicketType票种类型TRUEFALSE
IsConfirmImme是否立即确认FALSEFALSE
appointment预约信息FALSETRUE
RefundPolicy退款政策FALSETRUE
refund_need_merchant_confirm退款是否需商家审核FALSETRUE
auto_renew是否开启自动延期FALSETRUE
show_channel投放渠道FALSETRUE
image_list封面图TRUETRUE
environment_image_list环境图TRUEFALSE
detail_image_list长图TRUEFALSE
customer_reserved_info留资规则FALSEFALSE
real_name_info实名信息FALSEFALSE
use_type团购使用方式FALSETRUE
code_source_type券码生成方式FALSETRUE
settle_type收款方式FALSETRUE
limit_rule限制购买FALSETRUE
MpResourceID小程序资源idFALSEFALSE
market_price市场价FALSEFALSE
TagList标签列表FALSEFALSE
Description商品描述TRUETRUE
trade_url小程序提单页跳转FALSEFALSE
MpSettleType小程序分账类型FALSEFALSE
limit_use_rule限制使用FALSETRUE

attr_key_value_map 的格式#

根据「查询商品模板」查出的模板,可以看到该行业该类型下的商品对应的可传的相关属性,技术需要关心的字段主要是以下几个:
key - 属性主键,attr_key_value_map的key是什么
is_required - 是否必传
is_multi - 是否列表,需要和value_type组合起来看。例如:value_type=STRING(表示字符串,具体参见下文),is_multi=true,则表示value是一个字符串列表(也就是list < string >)类型;value_type=IMAGE(表示图片控件,具体参见下文),is_multi=true,则表示value是一个图片控件结构体列表(也就是list < ImageStruct >)类型;
value_type - attr_key_value_map的value类型,枚举可参见后文的表格。
attr_key_value_map 的类型是 map < string,string >,如果 value_type 为其他值类型需转换为 string
value_type为整数/浮点数:转为十进制格式的string
value_type为布尔值:转为"true"或"false"
value_type为结构体或结构体列表:需要使用json序列化
ID枚举值含义说明结构定义(thrift格式)
2INT64整数i64
3BOOL布尔值bool
4STRING字符串string
6DOUBLE浮点数double
100IMAGE图片控件(ImageStruct)url、名称struct ImageStruct { 1: optional string name 3: optional string url }
101USE_TIME使用时间控件(UseTimeStruct)全天/仅指定时间可用;时间段(比如12:-14:)enum UseTimeTypeEnum { ALL_DAY = 1 // 全天可用 SPECIFIC_TIME = 2 // 仅指定时间可用 } struct TimePeriodStruct { 2: required string use_start_time // 开始时间 00:00:00 3: required string use_end_time // 结束时间 00:00:00 4: optional bool end_time_is_next_day // 是否跨天 } struct UseTimeStruct { 1: required UseTimeTypeEnum use_time_type // 1全天可用,2仅指定时间可用 2: optional list < TimePeriodStruct > time_period_list // 时间段 }
103USE_DATE可使用日期(UseDateStruct)指定日期/指定天数;购买后多少天有效;可用开始时间;可用结束时间;enum UseDateTypeEnum { SPECIFIC_DATE = 1 // 指定日期 RELATIVE_DATE = 2 // 指定天数 } struct UseDateStruct { 1: required UseDateTypeEnum use_date_type // 1指定日期 2指定天数; 2: optional i32 day_duration // 购买后X天有效,use_date_type=2时有效 3: optional string use_start_date // yyyy-MM-dd 开始日期,use_date_type=1时有效 4: optional string use_end_date // yyyy-MM-dd 结束日期,use_date_type=1时有效 }
104CAN_NO_USE_DATE不可使用日期(CanNoUseDateStruct)开关;指定周几不可用;指定节假日不可用;指定日期不可用;节假日具体日期 入参示例:"{"days_of_week":[1],"holidays":[1],"enable":true}"enum HolidayEnum { NEW_YEAR = 1 // 元旦 SPRING_FESTIVAL = 2 // 春节 TOMB_SWEEPING_DAY = 3 // 清明 MAY_DAY = 4 // 劳动节 DRAGON_BOAT_FESTIVAL = 5 // 端午节 MID_AUTUMN_FESTIVAL = 6 // 中秋节 NATIONAL_DAY = 7 // 国庆节 VALENTINE_DAY = 8 // 情人节 CHRISTMAS = 9 // 圣诞节 } enum DayOfWeekEnum { MONDAY = 1 TUESDAY = 2 WEDNESDAY = 3 THURSDAY = 4 FRIDAY = 5 SATURDAY = 6 SUNDAY = 7 } struct CanNoUseDateStruct { 1: required bool enable // 开关,启用需要为true 2: optional list < DayOfWeekEnum > days_of_week // 指定周几不可用 3: optional list < HolidayEnum > holidays // 指定节假日不可用 4: optional list < string > date_list // yy-MM-dd 指定日期,不可用 5: optional map < HolidayEnum, string > holiday_dates // 节假日不可用具体日期,例如:"holiday_dates":{"1":"2021.01.01-2021.01.03","7":"2021.10.01-2021.10.07"} }
105APPOINTMENT预约控件(AppointmentStruct)是否需要预约;提前X天;提前X小时;第三方预约入口;第三方已预约订单查看入口;需预约日期类型(1-指定周期、2-指定日期);需周几;需预约日期 入参示例:"{"need_appointment":true,"ahead_time_type":1,"ahead_day_num":2}"enum AheadTimeTypeEnum { DAY = 1 HOUR = 2 MINUTE = 3 } struct AppointmentStruct { 1: optional bool need_appointment // 是否需要预约 2: optional i32 ahead_day_num // 需要提前X天电话预约 3: optional string external_link // 第三方提供预约入口,需要过机审。 4: optional string order_appointment_time_url // 第三方提供的查看已预约订单入口,需要过机审 5: optional AheadTimeTypeEnum ahead_time_type // 提前预约时间类型, need_appointment = true时该字段必填 6: optional i32 ahead_hour_num // 需要提前X小时电话预约 7: optional i32 ahead_minute_num // 需要提前X分钟电话预约 }
106NOTE富文本控件(NoteStruct)类型(文本/图片);内容enum OtherNoteTypeEnum { TEXT = 1 // 文本 IMG = 2 // 图片 } struct NoteStruct { 1: optional OtherNoteTypeEnum note_type 2: optional string content }
107LIMIT_USE_RULE限制使用规则控件(LimitUseRuleStruct)是否限制、每人单次消费最多使用代金劵张数struct LimitUseRuleStruct { 1: required bool is_limit_use // 是否限用 2: optional i32 use_num_per_consume // 每人单次消费最多使用代金劵张数 }
108CUSTOMER_RESERVED_INFO用户留资规则控件(CustomerReservedInfoStruct)是否留资;可以留电话;可以留姓名;可以留身份证;手机号是否必传;是否每张券都要留资;留资原因struct CustomerReservedInfoStruct { 1: required bool allow //是否留资 2: optional bool allow_tel //可以留电话 3: optional bool allow_name // 可以留姓名 4: optional bool allow_identity // 可以留身份证 5: optional bool require_for_tel //手机号是否必传 【默认非必传】 10: optional bool need_for_all // 是否每张券都需要留资 }
109REAL_NAME_INFO实名信息控件(RealNameInfoStruct)是否实名;场景enum RealNameInfoSceneEnum { NAME_AND_TEL = 3 // 出行人姓名与手机号码 ONLY_ONE_INFO = 2 // 仅填写一位游客信息 EVERY_ONE_INFO = 1 // 每张门票都要填写用户信息 } struct RealNameInfoStruct { 1: required bool enable 2: required RealNameInfoSceneEnum scene // 场景(1/2/3) }
111HIGHLIGHT商品亮点标签控件(HighlightStruct)Content、Prioritystruct HighlightStruct{ 1: required string Content 2: required i64 Priority }
112FACILITY酒店设施控件(FacilityStruct)value、name、iconstruct FacilityStruct { 1: required string value, // 设施ID 1 - 空调; 2 - 电视; 3 - 阳台; 4 - 窗户; 5 - 独立卫浴; 6 - 浴缸; 7 - 吹风机; 8 - 衣架; 9 - 热水; 10 - 洗衣机; 11 - 基本厨具; 12 - 冰箱; 13 - 免费Wifi; 14 - 电热水壶; 15 - 暖气; 16 - 智能马桶; 17 - 微波炉; 18 - 门禁系统; 19 - 智能门锁; 20 - 私家花园; 21 - 私家泳池; 22 - 观景露台; 23 - 免费停车; 24 - 行李寄存 2: optional string name, // 设施名称,code != -1 时展示name,其他情况下展示code对应的名称。长度不超过6字符 }
114NOTIFICATION使用规则控件(NotificationStruct)标题;内容struct NotificationStruct { 1: required string title, 2: required string content, }
116ADD_BED_RULE加床规则控件(AddBedRuleStruct)是否支持加床;加床规则(文本)struct AddBedRuleStruct { 1: required bool can_add_bed (go.tag = 'json:"can_add_bed"'), //是否支持加床 2: optional string add_bed_rule (go.tag = 'json:"add_bed_rule"'), //加床规则,文本,最多200个 }
117DATE_RULE使用日期规则控件(DateRuleStruct)指定周几不可用;指定日期不可用;是否节日不可用struct UnavailableDateStruct{ 1: optional list < string > date_list // yyyy-MM-dd 指定日期,不可用 2: optional list < i64 > weekday_list // 1-7对应周一至周日 3: optional bool not_available_on_holidays // 节假日不可用 } struct DateRuleStruct{ 1: optional UnavailableDateStruct unavailable_date }
118BREAKFAST加早规则控件(BreakfastRule)是否支持加早;加早规则自定义文本struct BreakfastRule { 1: required bool can_add_breakfast (go.tag = 'json:"can_add_breakfast"'), //是否支持加早 2: optional string add_breakfast_rule (go.tag = 'json:"add_breakfast_rule"'), //加早规则,文本,最多200个 }
121COMMODITY商品搭配控件(ItemGroupStruct)商品组名 总数 选几 菜品 - 菜名 - 单价 - 总数 - 单位
struct ItemStruct { 1: required string name // 菜名 2: required i64 price // 价格 3: required i32 count // 总数 4: optional string unit // 单位 (美食团购必填) } struct ItemGroupStruct { 1: required string group_name // 商品组名 2: optional i32 total_count // 总数 3: required i32 option_count // 选几 4: required list < ItemStruct > item_list // 菜品 }
122LIMIT_RULE限制购买规则控件(LimitRuleStruct)是否限购;每人最多购买X张struct LimitRuleStruct { 1: required bool is_limit // 是否限购 2: optional i32 total_buy_num // 每人最多购买X张 }
126CUSTOM_POLICY自定义规则控件(CustomPolicyStruct)自定义规则控件struct CustomPolicyStruct { 1: required i64 policy_rule_type // 规则类型 2: optional string policy_value // 规则值 3: optional NoteStruct note //规则描述 }
127CHARGE_POLICY费用控件(ChargePolicyStruct)加早、加床费用,支持添加费用类型,填写名称、单位和价格,价格支持选择免费struct ChargePolicyItem { 1: required string item // 费用项名称 3: required i64 qty //数量 4: required string unit //单位 5: required i64 amount // 金额(分) }
针对 value 为对象 json 的属性字段补充
keyname内容格式备注
NearestOrderTime最早可预定时间新接口直接传文本字符串,必须为以下所示的五种类型之一 类型1: value="最早可订今日"类型2: value="最早可订明日"类型3: value="最早可订6月13日"类型4: value="19:59前可订当日"类型5: value="需提前1天预订"以下为老接口数据格式,新接入无需关心,供老服务商接入时对比参考struct { 1: optional string time 2: required i64 time_type}Enum time_type { 1 // 转义:最早可订今日 无需传time 2 // 最早可订明日 无需传time 3 // 最早可订5月7日 time格式:"20220517" 4 // xx:xx前可订当日 time格式:"19:59" 5 // 需提前x天预订 time格式:"1"}

关键属性介绍#

属性key属性名枚举值说明is_multi属性类型
appointment预约信息消费提示:做展示使用falseAPPOINTMENT
auto_renew是否开启自动延期falseBOOL
bring_out_meal是否可以外带餐食消费提示:做展示使用falseBOOL
can_no_use_date不可使用日期消费提示里注明的不可使用日期,可以天、星期和节日falseCAN_NO_USE_DATE
cooperation_mode合作模式"DIRECT = 1 // 直连; INDIRECT = 2 // 间连 ",falseINT64
customer_reserved_info留资规则falseCUSTOMER_RESERVED_INFO
description_rich_text其他说明信息trueNOTE
detail_image_list长图图片比例无限制trueIMAGE
dishes_image_list菜品图图片比例:375:280trueIMAGE
EntryType入口类型"1:H5 2:小程序 3:抖音 4:lynx",falseINT64
environment_image_listz图片比例:375:280trueIMAGE
free_pack是否可以打包消费提示:做展示使用falseBOOL
FrontCategoryTagtrueSTRING
image_list封面图图片比例:375:280trueIMAGE
IndustryType商品行业类型falseSTRING
IsConfirmImme是否立即确认falseBOOL
MpResourceID小程序资源idfalseSTRING
MpSettleType小程序分账类型"1-包销 2-代销",三方分账使用falseINT64
Notification使用规则trueNOTIFICATION
private_room是否可以使用包间消费提示:做展示使用falseBOOL
real_name_info实名信息falseREAL_NAME_INFO
RecommendWord推荐语falseSTRING
rec_person_num建议使用人数falseINT64
rec_person_num_max最多使用人数falseINT64
RefundPolicy退款政策"1-允许退款 2-不可退款 3-有条件退",falseINT64
refund_need_merchant_confirm退款是否需商家审核falseBOOL
show_channel"1-不限制 2-仅直播间可见",falseINT64
SortWeight排序权重falseINT64
superimposed_discounts可以享受店内其他优惠消费提示:做展示使用falseBOOL
TagList标签列表falseSTRING
trade_url小程序提单页跳转提单页URL,直播间下单会使用falseSTRING
use_date使用日期券码的可以核销日期,履约核销强依赖falseUSE_DATE
use_time使用时间用户可以消费的时间falseUSE_TIME
code_source_type券码生成方式"1-抖音码 2-三方码 3-预导码", 抖音码 :即交易后,抖音发券码,通过抖音侧进行核销,然后同步到开发者。当前仅针对白名单开发者开放。 三方码 :即交易后,开发者发券码,在开发者侧进行核销,然后核销以及订单状态,同步到抖音。 预导码:可忽略falseINT64
commodity菜品搭配trueCOMMODITY
limit_rule限制购买最多购买份数falseLIMIT_RULE
market_price即菜品搭配里的总价falseINT64
settle_type收款方式"1-总店结算 2-分店结算", 总店结算:即商品的结算资金统一结算到商家(不是开发者)的收款账户。 分店结算:按核销POI将资金结算到对应的POI的收款账户,如果POI没有设置收款账户,会将对应的POI的结算资金打款到总店账户;falseINT64
use_type团购使用方式"1-到店核销",默认值falseINT64
SubTitle副标题过期退;随时退;x日内可退;免预约;提前x日预约;多个副标题以|(英文半角)分隔,不要有空格
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://dev-cn.your-api-server.com/life/goods/template/get/?access_token=clt.xxxxx&product_type=1&category_id=1001001'
响应示例响应示例
{
  "data": {
    "product_attrs": [
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "appointment",
        "name": "预约信息",
        "value_demo": "",
        "value_type": "APPOINTMENT"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "auto_renew",
        "name": "是否开启自动延期",
        "value_demo": "",
        "value_type": "BOOL"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "bring_out_meal",
        "name": "是否可以外带餐食",
        "value_demo": "",
        "value_type": "BOOL"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "can_no_use_date",
        "name": "不可使用日期",
        "value_demo": "",
        "value_type": "CAN_NO_USE_DATE"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "customer_reserved_info",
        "name": "留资规则",
        "value_demo": "",
        "value_type": "CUSTOMER_RESERVED_INFO"
      },
      {
        "desc": "",
        "is_multi": true,
        "is_required": false,
        "key": "description_rich_text",
        "name": "其他说明信息",
        "value_demo": "",
        "value_type": "NOTE"
      },
      {
        "desc": "",
        "is_multi": true,
        "is_required": false,
        "key": "detail_image_list",
        "name": "长图",
        "value_demo": "",
        "value_type": "IMAGE"
      },
      {
        "desc": "",
        "is_multi": true,
        "is_required": false,
        "key": "dishes_image_list",
        "name": "菜品图",
        "value_demo": "",
        "value_type": "IMAGE"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "EntryType",
        "name": "入口类型",
        "value_demo": "1:H5 2:小程序 3:抖音 4:lynx",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": true,
        "is_required": false,
        "key": "environment_image_list",
        "name": "环境图",
        "value_demo": "",
        "value_type": "IMAGE"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "free_pack",
        "name": "是否可以打包",
        "value_demo": "",
        "value_type": "BOOL"
      },
      {
        "desc": "",
        "is_multi": true,
        "is_required": false,
        "key": "FrontCategoryTag",
        "name": "前台品类标签",
        "value_demo": "",
        "value_type": "STRING"
      },
      {
        "desc": "",
        "is_multi": true,
        "is_required": true,
        "key": "image_list",
        "name": "封面图",
        "value_demo": "",
        "value_type": "IMAGE"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "IndustryType",
        "name": "商品行业类型",
        "value_demo": "",
        "value_type": "STRING"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "IsConfirmImme",
        "name": "是否立即确认",
        "value_demo": "",
        "value_type": "BOOL"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "MpResourceID",
        "name": "小程序资源id",
        "value_demo": "",
        "value_type": "STRING"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "MpSettleType",
        "name": "小程序分账类型",
        "value_demo": "1-包销 2-代销",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": true,
        "is_required": true,
        "key": "Notification",
        "name": "使用规则",
        "value_demo": "",
        "value_type": "NOTIFICATION"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "private_room",
        "name": "是否可以使用包间",
        "value_demo": "",
        "value_type": "BOOL"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "real_name_info",
        "name": "实名信息",
        "value_demo": "",
        "value_type": "REAL_NAME_INFO"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "RecommendWord",
        "name": "推荐语",
        "value_demo": "",
        "value_type": "STRING"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "rec_person_num",
        "name": "建议使用人数",
        "value_demo": "",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "rec_person_num_max",
        "name": "最多使用人数",
        "value_demo": "",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "RefundPolicy",
        "name": "退款政策",
        "value_demo": "1-允许退款 2-不可退款 3-有条件退",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "refund_need_merchant_confirm",
        "name": "退款是否需商家审核",
        "value_demo": "",
        "value_type": "BOOL"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "show_channel",
        "name": "投放渠道",
        "value_demo": "1-不限制 2-仅直播间可见",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "SortWeight",
        "name": "排序权重",
        "value_demo": "",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "superimposed_discounts",
        "name": "可以享受店内其他优惠",
        "value_demo": "",
        "value_type": "BOOL"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "TagList",
        "name": "标签列表",
        "value_demo": "",
        "value_type": "STRING"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "trade_url",
        "name": "小程序提单页跳转",
        "value_demo": "",
        "value_type": "STRING"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "use_date",
        "name": "使用日期",
        "value_demo": "",
        "value_type": "USE_DATE"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "use_time",
        "name": "使用时间",
        "value_demo": "",
        "value_type": "USE_TIME"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "SubTitle",
        "name": "副标题",
        "value_demo": "可选标题:过期退;随时退;x日内可退;免预约;提前x日预约;多个副标题以|(英文半角)分隔,不要有空格",
        "value_type": "STRING"
      }
    ],
    "sku_attrs": [
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "code_source_type",
        "name": "券码生成方式",
        "value_demo": "1-抖音码 2-三方码 3-预导码",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": true,
        "is_required": true,
        "key": "commodity",
        "name": "菜品搭配",
        "value_demo": "",
        "value_type": "COMMODITY"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "limit_rule",
        "name": "限制购买",
        "value_demo": "",
        "value_type": "LIMIT_RULE"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": false,
        "key": "market_price",
        "name": "市场价",
        "value_demo": "",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "settle_type",
        "name": "收款方式",
        "value_demo": "1-总店结算 2-分店结算",
        "value_type": "INT64"
      },
      {
        "desc": "",
        "is_multi": false,
        "is_required": true,
        "key": "use_type",
        "name": "团购使用方式",
        "value_demo": "1-到店核销",
        "value_type": "INT64"
      }
    ]
  },
  "base": {
    "log_id": "202205121547310102120681610A00B9B0",
    "gateway_code": 0,
    "gateway_msg": "",
    "biz_code": 0,
    "biz_msg": ""
  }
}

请求参数

Query 参数
access_token
string 
必需
调用/oauth/client_token/生成的token,此token不需要用户授权。
示例值:
clt.xxxxx
product_type
string 
必需
行业类目;详细见; 商品类目表
示例值:
1
category_id
string 
必需
商品类型 1 : 团购套餐 3 : 预售券 4 : 日历房 5 : 门票 7 : 旅行跟拍 8 : 一日游 11 : 代金券
示例值:
1001001

返回响应

🟢200成功
application/json
Body
data
object 
业务参数
必需
product_attrs
array [object {7}] 
商品属性列表
必需
sku_attrs
array [object {7}] 
SKU属性列表
必需
base
object 
公共参数
必需
log_id
string 
请求日志ID
必需
gateway_code
integer 
网关状态码
必需
gateway_msg
string 
网关状态信息
必需
biz_code
integer 
业务状态码
必需
biz_msg
string 
业务状态信息
必需
上一页
同步库存
下一页
查询商品草稿数据
Built with