接口文档 / 营销接口

查询营销卡项列表

GET/api/v2/open-agency/promotions/card/list在线调试

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`promotionCards`可选	营销卡项列表	`array<object>`
`total`可选	总条数示例：`100`	`integer`
`offset`可选	分页偏移示例：`0`	`integer`
`limit`可选	分页大小示例：`20`	`integer`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "promotionCards": [
      {
        "id": 1809264834875924500,
        "name": "测试卡",
        "status": 0,
        "isNeedCardFee": 1,
        "cardFee": 100,
        "validityType": 0,
        "validityPeriod": 7,
        "validityPeriodUnit": 1,
        "validityEndDate": "2026-01-01T00:00:00Z"
      }
    ],
    "total": 100,
    "offset": 0,
    "limit": 20
  },
  "error": null
}

业务失败包装示意

json

{
  "data": null,
  "error": {
    "code": 11003,
    "message": "不支持的授权类型{grantType}"
  }
}

查看 HTTP 状态与业务码排查