微笑发券 - 营销中心

请求参数

Body 参数application/json

appKey

string

访问者的AppKey，用于验证程序

必需

data

object

必需

mobilePhone

string

手机号码

必需

businessId

string

业务端

必需

businessSystemId

string

业务体系id

必需

快递业务体系：expressBusiness

couponList

array [object {2}]

发放券列表

必需

operator

string

操作人

必需

operatorOrgId

string

操作人所属组织id

可选

operatorOrgType

string

操作人所属组织类型

可选

示例

{
    "appKey": "weixiao",
    "data": {
        "mobilePhone": "19817207369",
        "couponList": [
            {
                "couponId": "71781189232058380",
                "qty": 1
            },
            {
                "couponId": "182078430052057357",
                "qty": 1
            }
        ],
        "businessSystemId": "expressBusiness",
        "businessId": "cssp"
    },
    "operator": "98692119",
    "operatorOrgType": "1",
    "operatorOrgId": "1"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/promotioncenter/coupon/pickup/smile' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "weixiao",
    "data": {
        "mobilePhone": "19817207369",
        "couponList": [
            {
                "couponId": "71781189232058380",
                "qty": 1
            },
            {
                "couponId": "182078430052057357",
                "qty": 1
            }
        ],
        "businessSystemId": "expressBusiness",
        "businessId": "cssp"
    },
    "operator": "98692119",
    "operatorOrgType": "1",
    "operatorOrgId": "1"
}'

返回响应

🟢200成功

application/json

Body

code

string

响应码

必需

message

string | null

响应信息

必需

data

array [object {15}]

优惠券领用列表

必需

id

string

券实例id

必需

code

string

券实例code

必需

couponInstanceStatus

string

券实例状态

必需

CREATED-已创建；UNUSED-未使用；USED-已使用；WRITE_OFF-已核销；EXPIRED-已过期；TRANSFERRING-转赠中

pickupUserId

string

发放/领取人Id

必需

mobilePhone

string

手机号

必需

useStartTime

string

使用时间开始

必需

useEndTime

string

使用时间结束

必需

remark

string

备注

必需

useTime

string

使用时间

必需

pickupTime

string

发放/领取时间

必需

businessId

string

发放/领取业务端

必需

businessSystemId

string

发放/领取业务体系

必需

couponId

string

券主表Id

必需

createBy

string

创建时间

必需

modifyBy

string

更新时间

必需

success

boolean

响应状态

必需

示例

{
    "code": "200",
    "message": null,
    "data": [
        {
            "id": 188931040608669900,
            "code": "SZliyuyIxDKW833",
            "couponInstanceStatus": "UNUSED",
            "pickupUserId": 350085756416008060,
            "mobilePhone": "15817207368",
            "useStartTime": "2021-12-27T16:00:00.000+0000",
            "useEndTime": "2022-04-18T15:59:59.000+0000",
            "remark": "",
            "useTime": null,
            "pickupTime": "2021-12-28T05:16:01.895+0000",
            "businessId": "wxapp",
            "businessSystemId": "expressBusiness",
            "couponId": 1181176381101229600,
            "createBy": "98692119",
            "modifyBy": null
        },
        {
            "id": 188931040756609250,
            "code": "CMVj8vyIxDs0ugG",
            "couponInstanceStatus": "UNUSED",
            "pickupUserId": 350085756416008060,
            "mobilePhone": "15817207368",
            "useStartTime": "2021-12-27T16:00:00.000+0000",
            "useEndTime": "2022-01-04T15:59:59.000+0000",
            "remark": "",
            "useTime": null,
            "pickupTime": "2021-12-28T05:16:06.176+0000",
            "businessId": "wxapp",
            "businessSystemId": "expressBusiness",
            "couponId": 35198811439172216,
            "createBy": "98692119",
            "modifyBy": null
        }
    ],
    "success": true
}