Appearance

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

拥有此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专属tokenxxxxxxx
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支付渠道，默认是00-线上微信，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否intapi优惠金额...
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"
    }
}