抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 门店管理
  • 团购核销
  • 团购对账
  • 会员接入
  • 订单查询
  • 三方码
  • 商品发布
  • 创建/更新商品接口
  • 免审修改商品接口
  • 上下架商品
  • 同步库存
  • 创建/更新多SKU商品的SKU列表
  • 创建适用人群
  • 商品状态变更通知
  • 代运营
  • 团购退款
  • 商品查询
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 创建适用人群

    收藏
    我的收藏
    创建预售券适用人群信息,用于景区,可配置儿童、成人、老人 3 种人群,老人不允许设置身高条件​

    使用限制

    无​

    接口说明

      配置适用人群后,才能创建商品关联适用人群​
      只能新增和修改人群,不能删除已有人群​
      对于相同的 poi_id 重复创建会被覆盖​

    基本信息

    名称​
    描述​
    HTTP URL​
    HTTP Method​
    POST​
    申请权限​
    门店管理​
    权限要求​
      需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案 ​
      需要商家授权,路径:抖音来客>店铺管理>服务应用授权​

    请求头

    名称​
    类型​
    必填​
    描述​
    access-token​
    string​
    TRUE​
    根据这个地址获取的token​
    Content-Type​
    Json​
    TRUE​
    application/json​

    请求参数

    Body

    名称​
    类型​
    是否必填​
    描述​
    account_id​
    string​
    TRUE​
    商家ID;传入时服务商须与该商家满足授权关系,在开平应用详情的授权管理界面可以查看​
    poi_id​
    string​
    TRUE​
    抖音POI_ID(即门店id)​
    crowds​
    list<corwdstruct>​
    TRUE​
    人群列表​
    - crowd_type​
    int​
    TRUE​
    人群类型​
    Child=1 儿童​
    Adult=2 成人​
    Old=3 老人​
    - age_condition​
    AgeConditionStruct​
    FALSE​
    年龄条件(身高条件两者至少有一个)​
    -- lower_bound​
    int​
    FALSE​
    年龄下界​
    -- lower_bound_type​
    int​
    FALSE​
    年龄下界包含与否​
    Contain=1 包含​
    NotContain=2 不包含​
    -- upper_bound​
    int​
    FALSE​
    年龄上界​
    -- upper_bound_type​
    int​
    FALSE​
    年龄上界包含与否​
    Contain=1 包含​
    NotContain=2 不包含​
    - height_condition​
    HeightConditionStruct​
    FALSE​
    身高条件(年龄条件两者至少有一个)​
    -- lower_bound​
    int​
    FALSE​
    最低身高,单位cm​
    -- lower_bound_type​
    int​
    FALSE​
    最低身高边界包含与否​
    Contain=1 包含​
    NotContain=2 不包含​
    -- upper_bound​
    int​
    FALSE​
    最高身高,单位cm​
    -- upper_bound_type​
    int​
    FALSE​
    最高身高边界包含与否​
    Contain=1 包含​
    NotContain=2 不包含​
    - op_type​
    int​
    FALSE​
    年龄身高与或关系​
    And=1 且​
    Or=2 或​
    - note​
    string​
    FALSE​
    特殊说明​

    请求 cURL 示例

    响应参数

    名称​
    类型​
    是否必填​
    描述​
    extra​
    struct​
    TRUE​
    公共参数,接口调用结果​
    - logid​
    string​
    TRUE​
    请求日志ID​
    - error_code​
    i32​
    TRUE​
    错误码​
    - description​
    string​
    TRUE​
    错误信息​
    - sub_error_code​
    i32​
    TRUE​
    业务状态码​
    - sub_description​
    string​
    TRUE​
    业务状态信息​
    - now​
    i32​
    TRUE​
    当前时间​
    data​
    struct​
    TRUE​
    返回数据,业务数据结果​
    - error_code​
    i32​
    TRUE​
    错误码​
    - description​
    string​
    TRUE​
    错误信息​

    响应示例​

    正常示例​