批量开通用户产品包权益-创建任务

拥有此API的权限集
订购管理-增删改

接口描述

  • 创建批量用户开通产品包权益的任务

请求方式及url

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://api.xiaoe-tech.com/xe.order.delivery.create_task/1.0.0
  • 频率限制:10秒500次

在线调试工具

请求

响应

请求参数

参数名 必选 类型 说明 备注(示例)
access_token string 专属token xxxxxxx
title string 标题
remark string 备注
list array 批量用户开通产品包列表 支持的最大长度为500条

list批量用户开通产品包列表

参数名 必选 类型 说明 备注(示例)
list[].user_id string 用户 ...
list[].data.payment_type int 付费类型 payment_type =2为单品, payment_type =3为产品包,payment_type=15为超级会员(详细见备注)
list[].data.resource_type int 资源类型 ...
list[].data.resource_id string 单品ID 当payment_type=2时,必填
list[].data.product_id string 产品包ID 当payment_type=3时,必填
list[].data.user_id string 用户ID ...
data.out_order_id string 外部订单号 ...
list[].data.pay_way int 支付渠道,默认是0 0-线上微信,2-线上支付宝,1-未指定方式
list[].data.channel_id string 渠道ID ...
list[].data.channel_info string 渠道来源 ...
list[].data.period string 有效期 秒数,超级会员订单:必传,详情见备注
list[].data.period_time string 买会员的开始时间 2019-02-20 15:15:00,超级会员订单:必传
list[].data.agent string 用户设备信息 ...
list[].data.discount_price int api优惠金额 ...
list[].data.source int 开通知识带货商品必传:10 目前暂不支持知识带实物和实物带货

备注

  1. payment_type类型说明
    • payment_type=2表示单品,包含:图文,音频,视频,直播,社群,新课程/训练营pro;开通以上课程时,课程id通过data.resource_id传入;
    • payment_type=3表示产品包,包含:专栏,会员,大专栏,训练营;开通以上课程时,课程id传data.product_id;
    • payment_type=15表示超级会员,包含:超级会员;开通超级会员时,data.product_id传超级会员id;
  2. resource_type表示课程或资源类型
    • 1-图文,2-音频,3-视频,4-直播,5-会员,6-专栏,7-社群,8-大专栏,23-超级会员,25-训练营,50-新课程/训练营pro;
  3. 会员是有有效期的,当多次调取开课接口,在有效期内视为续费订单,有效期做累加
  4. 关于超级会员的时长计算
    • period 过期时间(秒数)目前小鹅通可自定义类型:7天,一个月(30天),3个月(90天),半年(180天),一年(365天),示例:604800,开通超级会员必传;
    • period_time购买超级会员的开始(生效)时间,类型:日期,示例:2019-02-20 15:15:00,开通超级会员必传;
    • 超级会员过期时间:是购买超级会员的开始生效时间(period_time)加上period时长;
    • 如果在当前用户超级会员过期时间内再次开通超级会员,算为续费订单,过期时间做累加;

请求示例

{
    "access_token": "{{token}}",
    "title": "hamzachen",
    "remark": "这是一个备注",
    "list": [
        {
            "user_id": "user_id_1",
            "data": {
                "payment_type": 2,
                "resource_type": 3,
                "resource_id": "resource_id_1",
                "product_id": "product_id_1",
                "user_id": "user_id_1"
            }
        },
        {
            "user_id": "user_id_2",
            "data": {
                "payment_type": 2,
                "resource_type": 3,
                "resource_id": "resource_id_2",
                "product_id": "product_id_2",
                "user_id": "user_id_2"
            }
        },
        {
            "user_id": "user_id_3",
            "data": {
                "payment_type": 2,
                "resource_type": 3,
                "resource_id": "resource_id_3",
                "product_id": "product_id_3",
                "user_id": "user_id_3"
            }
        }
    ]
}

返回参数

参数名 必选 类型 说明 备注
code int 请求结果码 100600=成功;100601=失败
msg string 描述信息
data object 数据
data.task_id string 任务id

返回示例

{
    "code": 100600,
    "msg": "ok",
    "data": {
        "task_id": "CkTHxJmNxrJ9"
    }
}

results matching ""

    No results matching ""