List Coupons
curl --request GET \
--url https://uat-api.clinkbill.com/api/coupon \
--header 'X-API-KEY: <api-key>' \
--header 'X-Timestamp: <x-timestamp>'HttpResponse<String> response = Unirest.get("https://uat-api.clinkbill.com/api/coupon")
.header("X-Timestamp", "<x-timestamp>")
.header("X-API-KEY", "<api-key>")
.asString();import requests
url = "https://uat-api.clinkbill.com/api/coupon"
headers = {
"X-Timestamp": "<x-timestamp>",
"X-API-KEY": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Timestamp': '<x-timestamp>', 'X-API-KEY': '<api-key>'}
};
fetch('https://uat-api.clinkbill.com/api/coupon', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"total": 123,
"rows": [
{
"couponId": "<string>",
"couponName": "<string>",
"discountType": "percentage",
"percentage": 123,
"fixedAmounts": {},
"durationType": "once",
"durationMonths": 123,
"maxRedemptionCount": 123,
"redeemedCount": 123,
"validPeriodEnd": 1754819711382,
"mirroring": true,
"terms": "<string>"
}
],
"code": 200,
"msg": "success"
}"<string>"Coupon
查询优惠券列表
List coupons under your current merchant account with optional filters.
GET
/
coupon
List Coupons
curl --request GET \
--url https://uat-api.clinkbill.com/api/coupon \
--header 'X-API-KEY: <api-key>' \
--header 'X-Timestamp: <x-timestamp>'HttpResponse<String> response = Unirest.get("https://uat-api.clinkbill.com/api/coupon")
.header("X-Timestamp", "<x-timestamp>")
.header("X-API-KEY", "<api-key>")
.asString();import requests
url = "https://uat-api.clinkbill.com/api/coupon"
headers = {
"X-Timestamp": "<x-timestamp>",
"X-API-KEY": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Timestamp': '<x-timestamp>', 'X-API-KEY': '<api-key>'}
};
fetch('https://uat-api.clinkbill.com/api/coupon', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"total": 123,
"rows": [
{
"couponId": "<string>",
"couponName": "<string>",
"discountType": "percentage",
"percentage": 123,
"fixedAmounts": {},
"durationType": "once",
"durationMonths": 123,
"maxRedemptionCount": 123,
"redeemedCount": 123,
"validPeriodEnd": 1754819711382,
"mirroring": true,
"terms": "<string>"
}
],
"code": 200,
"msg": "success"
}"<string>"授权
Your secret API key obtained from the Clink dashboard (Developers section)
请求头
Current timestamp in milliseconds since Unix epoch (required for request signing)
示例:
"1783513683000"
查询参数
Discount type used to filter coupons
可用选项:
percentage, fixed_amount Discount duration type used to filter coupons
可用选项:
once, repeating, forever Current page number. Defaults to 1.
Number of records per page. Defaults to 20. The maximum is 50; larger values are capped at 50.
必填范围:
x <= 50