优惠券使用记录

Developing

测试环境

https://tapi.antong56.com:8443/antong-api/api-platform

POST

/api/coupon/v2/couponHistory

查询优惠券的使用记录

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://tapi.antong56.com:8443/antong-api/api-platform/api/coupon/v2/couponHistory' \
--header 'token: undefined' \
--header 'salt;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subsidiaryCompany": "",
    "couponNo": "202206135665",
    "bookingStartTime": "",
    "bookingEndTime": "",
    "boxNumber": "",
    "incomePoints": "",
    "billNumber": "",
    "blNo": "",
    "page": "1",
    "pagesize": "15"
}'

Response Example

{
    "state": "ok",
    "code": 20000,
    "msg": null,
    "errorMsg": null,
    "result": {
        "total": 20,
        "list": [
            {
                "deductNo": "202109040153-304",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095609623",
                "billNo": "ATIASHE210546561",
                "boxNo": null,
                "orderTime": "2021-09-05 15:38:17",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-305",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095610719",
                "billNo": "ATIASHE210547538",
                "boxNo": null,
                "orderTime": "2021-09-05 17:23:25",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-306",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095610603",
                "billNo": "ATIANNS210547433",
                "boxNo": null,
                "orderTime": "2021-09-06 08:58:35",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-307",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611300",
                "billNo": "ATIASHE210548032",
                "boxNo": null,
                "orderTime": "2021-09-06 10:02:23",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-308",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611397",
                "billNo": "ATIASHE210548115",
                "boxNo": null,
                "orderTime": "2021-09-06 10:15:41",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-309",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611398",
                "billNo": "ATIANNS210548116",
                "boxNo": null,
                "orderTime": "2021-09-06 10:15:46",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-310",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611445",
                "billNo": "ATIAWUO210548152",
                "boxNo": null,
                "orderTime": "2021-09-06 10:24:16",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-311",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611488",
                "billNo": "ATIAHMP210548188",
                "boxNo": null,
                "orderTime": "2021-09-06 10:29:46",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-312",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611593",
                "billNo": "ATIANNS210548287",
                "boxNo": null,
                "orderTime": "2021-09-06 10:44:59",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-313",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611593",
                "billNo": "ATIANNS210548287",
                "boxNo": null,
                "orderTime": "2021-09-06 10:44:59",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-314",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611655",
                "billNo": "ATIANAL210548336A",
                "boxNo": null,
                "orderTime": "2021-09-06 10:53:56",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-315",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611655",
                "billNo": "ATIANAL210548336A",
                "boxNo": null,
                "orderTime": "2021-09-06 10:53:56",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-316",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611655",
                "billNo": "ATIANAL210548336",
                "boxNo": null,
                "orderTime": "2021-09-06 10:53:56",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-317",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611655",
                "billNo": "ATIANAL210548336",
                "boxNo": null,
                "orderTime": "2021-09-06 10:53:56",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            },
            {
                "deductNo": "202109040153-318",
                "couponNo": "202109040153",
                "bookingNo": "AT2021095611655",
                "billNo": "ATIANAL210548336",
                "boxNo": null,
                "orderTime": "2021-09-06 10:53:56",
                "amount": 200,
                "detail": "优惠券+积分抵扣+积分获取"
            }
        ],
        "pageNum": 1,
        "pageSize": 15,
        "size": 15,
        "startRow": 1,
        "endRow": 15,
        "pages": 2,
        "prePage": 0,
        "nextPage": 2,
        "isFirstPage": true,
        "isLastPage": false,
        "hasPreviousPage": false,
        "hasNextPage": true,
        "navigatePages": 8,
        "navigatepageNums": [
            1,
            2
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 2
    },
    "responseOk": true
}

Request

Header Params

token

string

token令牌

必需

示例值:

salt

string

13位毫秒值时间戳

必需

sign

string

必需

数字签名，对salt + appSecret拼接字符串后使用国密SM3算法加密，生成16进制sign

Body Params application/json

couponNo

string

优惠券编号

可选

bookingNo

string

订单号

可选

billNo

string

运单号

可选

boxNo

string

箱号

可选

subsidiaryCompany

string

子公司名称

可选

查询当前账户可放空

bookingStartTime

string

订舱开始时间

可选

格式：yyyy-MM-dd

bookingEndTime

string

订舱结束时间

可选

格式：yyyy-MM-dd

incomePoints

string

积分获取

可选

1:可获取；0：不可获取；空值：全部

page

number

当前页数

必需

默认第1页

pagesize

number

一页显示条数

必需

默认15条

Examples

Responses

🟢200成功

application/json

Body

state

string

状态

必需

成功 ok；失败 fail；

code

integer

状态值

必需

成功 20000；其余为失败；

msg

string

消息文字

必需

errorMsg

string

报错信息

必需

responseOk

boolean

状态

必需

成功 true；失败 false；

result

object

必需

list

array [object {8}]

必需

total

integer

总记录数

必需

pageNum

string

当前页

必需

pageSize

integer

每页行数

必需

size

integer

当前页的数量

必需

startRow

integer

第一个元素行号

必需

当前页面第一个元素在数据库中的行号

endRow

integer

最后一个元素行号

必需

当前页面最后一个元素在数据库中的行号

pages

integer

总页数

必需

prePage

integer

前一页

必需

integer

必需

isFirstPage

boolean

是否为第一页

必需

isLastPage

boolean

是否为最后一页

必需

hasPreviousPage

boolean

是否有前一页

必需

hasNextPage

boolean

是否有下一页

必需

naxigatePages

integer

导航页码数

必需

naxigatePageNums

array[string]

所有导航页号

必需

naxigateFirstPage

integer

第一页

必需

导航条上的第一页

naxigateLastPage

integer

最后一页

必需

导航条上的最后一页

Modified at 2025-06-09 07:49:24

获取“我的优惠券”信息

优惠券可用订舱流向查询