# Get coupons

# Interface call request specification

Http request method: POST

# Request Parameter Sample


# Return Package Example

    "errcode": 0,
    "coupon": {
        "coupon_id": 12639900,
        "type": 103,
        "status": 5,
        "create_time": "2020-07-16 15:43:05",
        "update_time": "2020-07-16 15:58:47",
        "coupon_info": {
            "name": "scs",
            "promote_info": {
                "promote_type": "PROMOTE_TYPE_CUSTOMIZE",
                "customize_channel": "sc"
            "discount_info": {
                "discount_in a": 9900
            "valid_info": {
                "valid_type": "COUPON_VALID_TYPE_TIME",
                "valid_day_in a": 0,
                "start_time": "2020-07-16 00:00:00",
                "end_time": "2020-07-23 00:00:00"
        "stock_info": {}

# Request Parameter Dxplaination

parameter type Is it necessary to fill out Introductions
coupon_id number yes Coupon id

# Return parameter specification

parameter type Introductions
Errcode number Error code
errmsg string Error message
coupon.coupon_id number Coupon
coupon.type number Coupon Type
coupon.status number Coupon status
coupon.create_time string Coupon Creation Time
coupon.update_time string Coupon Renewal Time
coupon.coupon_info.name string Coupon Name
coupon.coupon_info.valid_info.valid_type string Coupon Validity Type, See table below
coupon.coupon_info.valid_info.valid_day_A number Coupon Valid Days_It makes sense when type = 2
coupon.coupon_info.valid_info.start_time string Coupon Validity Start Time_Type = 1 makes sense
coupon.coupon_info.valid_info.end_time string The end time of the coupon validity_Type = 1 makes sense
coupon.coupon_info.promote_info.promote_type string Types of promotion, see table below
coupon.coupon_info.promote_info.customize_channel string Custom promotion channel specific content, promote_It makes sense when type = 2
coupon.stock_info.issued_A number Coupon Surplus
coupon.stock_info.receive_A number Coupon usage
coupon.stock_info.used_A number Coupon used
coupon.coupon_info.discount_info.discount_A number Coupon Discounts * 1000, for example 5.1% -> 5100
coupon.coupon_info.discount_info.discount_fee number Coupons reduce the amount, Unit points, For example $0.5 -> 50
coupon.coupon_info.discount_info.discount_condition.product_cnt number Conditions for use of coupons, Full x items available
coupon.coupon_info.discount_info.discount_condition.product_price number Conditions for use of coupons, Price full x available, unit points
coupon.coupon_info.discount_info.discount_condition.product_ids[] number array Conditions for use of coupons, Specify product id available
coupon.coupon_info.ext_info.invalid_time string Coupon Expiration Time
coupon.coupon_info.ext_info.jump_product_id number Product id after receiving discount coupon
coupon.coupon_info.ext_info.notes string Remarks information
coupon.coupon_info.ext_info.valid_time string Coupon Valid Time
coupon.coupon_info.receive_info.end_time string End Time of Coupon Collection
coupon.coupon_info.receive_info.limit_A_one_person number Single Limited Tickets
coupon.coupon_info.receive_info.start_time string Coupon Collection Start Time
coupon.coupon_info.receive_info.total_A number Total number of coupons received

# Enumerations-type

Enumeration value describe
1 Discount coupon for condition of goods
2 Coupon Coupon
3 Unified Merchandise Discount Coupon
4 Commodities Direct Coupon
101 Shop Condition Discount Coupon
102 Shop full discount coupon
103 Shop unified discount coupon
104 Shop Direct Coupon

# Enumerations-promote_type

Enumeration field name Enumeration value describe
PROMOTE_TYPE_SHOP 1 Shop promotion
PROMOTE_TYPE_CUSTOMIZE 2 Custom promotion channels
PROMOTE_TYPE_TARGET 3 Directional discount

# Enumerations-valid_type

Enumeration field name Enumeration value describe
COUPON_VALID_TYPE_TIME 1 Product specified time interval
COUPON_VALID_TYPE_DAY 2 Days of entry into force

# Return code

Return code Type of error
-1 System exception
-2 Token is too long
9401020 Wrong parameter