接口文档 / 营销接口

查询患者卡详情

GET/api/v2/open-agency/promotions/card/patient/{id}在线调试

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`id`可选	患者卡ID 示例：`1688054295070408700`	`string`
`cardBalance`可选	卡余额	`number`
`principal`可选	卡本金	`number`
`present`可选	卡赠金	`number`
`created`可选	开卡日期格式：date-time	`string`
`beginDate`可选	生效日期格式：date-time	`string`
`endDate`可选	失效日期格式：date-time	`string`
`cardInfo`可选	卡项信息	`object`
`patient`可选	患者信息	`object`
`patientPresents`可选	持卡人赠送权益及使用情况	`array<object>`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "id": 1688054295070408700,
    "cardBalance": 0,
    "principal": 0,
    "present": 0,
    "created": "2026-01-01T00:00:00Z",
    "beginDate": "2026-01-01T00:00:00Z",
    "endDate": "2026-01-01T00:00:00Z",
    "cardInfo": {
      "id": 1809264834875924500,
      "name": "测试卡",
      "status": 0,
      "isNeedCardFee": 1,
      "cardFee": 100,
      "validityType": 0,
      "validityPeriod": 7,
      "validityPeriodUnit": 1,
      "validityEndDate": "2026-01-01T00:00:00Z",
      "perPatientObtainLimit": 1,
      "perPatientObtainMax": 2,
      "rechargeRights": {
        "isOpen": 1,
        "detail": {
          "rechargeRules": [
            {
              "pay": 100,
              "present": 1
            }
          ],
          "balanceUsingScope": 0,
          "goodsPayWithBalance": [
            {
              "discountType": 1,
              "discount": 0,
              "givingLimitType": 1,
              "givingCount": 3,
              "name": "string",
              "type": 0,
              "productId": "string",
              "exceptItems": [
                null
              ]
            }
          ]
        }
      },
      "discountRights": {
        "isOpen": 1,
        "detail": {
          "goodsList": [
            {
              "discountType": 1,
              "discount": 0,
              "givingLimitType": 1,
              "givingCount": 3,
              "name": "string",
              "type": 0,
              "productId": "string",
              "exceptItems": [
                null
              ]
            }
          ]
        }
      },
      "presentRights": {
        "isOpen": 1,
        "detail": {
          "singlePresentList": [
            {
              "discountType": 1,
              "discount": 0,
              "givingLimitType": 1,
              "givingCount": 3,
              "name": "string",
              "type": 0,
              "productId": "string",
              "exceptItems": [
                null
              ]
            }
          ],
          "packagePresentList": [
            {
              "itemTotalCount": 0,
              "itemChoiceCount": 0,
              "goodsList": [
                null
              ]
            }
          ]
        }
      }
    },
    "patient": {
      "id": "000000fc446f4dbd989857e305b00d6s",
      "name": "张三",
      "mobile": 18080000000,
      "sex": "男",
      "birthday": "1970-08-14",
      "age": "60岁2月1天",
      "idCard": 630101200010075800,
      "idCardType": "身份证",
      "visitReason": "string"
    },
    "patientPresents": [
      {
        "name": "string",
        "type": 0,
        "productId": "string",
        "givingLimitType": 1,
        "totalCount": 0,
        "usedCount": 0
      }
    ]
  },
  "error": null
}

业务失败包装示意

json

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

查看 HTTP 状态与业务码排查