总览 / 三省一卡通平台 / 卡续费接口(激活码续费)
POST/yikatongApi/card/renewByCard外部平台

卡续费接口(激活码续费)

三省一卡通平台 / 旅游卡模块· 导出更新 2023-10-07

基本信息

  • 接口状态已完成 来自 Apipost 导出,非本仓库代码
  • 接口URLPOSThttp://localhost:8090/yikatongApi/card/renewByCard
  • 请求方式POST
  • Content-Typeurlencoded
  • 调用方外部平台接口,由本系统服务端调用(不在 7 端前端扫描范围)
  • 所属分组旅游卡模块
  • 来源三省一卡通平台 Apipost 导出(原始页)
  • 接口说明卡续费接口(激活码续费)

请求参数

Header 请求参数

参数名参数值是否必填参数类型描述说明
tokeneyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJBUFBfU0VDUkVUIjoiMTlDQTE0RTdFQTYzMjhBNDJFMEVCMTNENTg1RTRDMjIiLCJleHAiOjE2OTY2NzE1NzZ9.GGKqKtBidmQSJxn_PH8KoPTReyszWYRyLYqk2C8pw24是String请求token

Query 请求参数

参数名参数值是否必填参数类型描述说明
无

路径参数及说明

参数名参数值是否必填参数类型描述说明
无

Body 请求参数

Body 模式:urlencoded
参数名参数值是否必填参数类型描述说明
numberoWyEDAm9zlL00na2是String消耗卡卡号
activeCodeENfLYFF99uHH63EL是String消耗卡激活码
cardId13是Number卡id

认证方式

认证方式:noauth(导出未标注具体鉴权,需与对方确认)

响应参数

参数名参数值是否必填参数类型描述说明
updateCard…是Object续费卡
expendCard…是Object消耗卡

响应示例

成功 code=200

{
	"msg": "操作成功",
	"code": 0,
	"data": {
		"updateCard": {
			"createTime": "2022-12-13 19:26:09",
			"updateTime": "2023-10-07 16:02:46",
			"id": 13,
			"modelId": 1,
			"cardBatchId": 1,
			"number": "HVzrP3F87dAroE6f",
			"activeCode": "EBHYYAY563YjL3LF",
			"marketPrice": 300,
			"price": 300,
			"status": 2,
			"bindStatus": 0,
			"openAgencyId": 1,
			"companyId": null,
			"agencyChannel": 0,
			"bindTime": null,
			"buyTime": "2022-12-13 19:26:09",
			"buyerId": 4773,
			"autoActivateTime": "2023-01-12 00:00:00",
			"ownerId": null,
			"channel": null,
			"openTime": "2022-12-13 19:26:09",
			"activateTime": "2023-01-12 00:00:00",
			"expireTime": "2025-01-11 00:00:00",
			"newActivateTime": null,
			"orgCode": "42",
			"yktCardModel": {
				"createTime": "2022-12-13 19:26:09",
				"updateTime": "2023-10-07 16:02:46",
				"id": 13,
				"name": null,
				"price": 300,
				"marketPrice": 300,
				"autoActiveDayAfterBuy": null,
				"periodOfValidity": null,
				"cover": null,
				"filmOrderTimes": null,
				"cardMaxBuyCount": null,
				"article": null
			},
			"expendTime": null,
			"expendRemark": null
		},
		"expendCard": {
			"createTime": "2022-12-13 19:26:09",
			"updateTime": "2022-12-16 22:29:21",
			"id": 15,
			"modelId": 1,
			"cardBatchId": 1,
			"number": "oWyEDAm9zlL00na2",
			"activeCode": "ENfLYFF99uHH63EL",
			"marketPrice": 300,
			"price": 300,
			"status": 7,
			"bindStatus": 0,
			"openAgencyId": null,
			"companyId": null,
			"agencyChannel": 0,
			"bindTime": null,
			"buyTime": "2022-12-13 19:26:09",
			"buyerId": 4800,
			"autoActivateTime": "2023-01-12 00:00:00",
			"ownerId": null,
			"channel": null,
			"openTime": "2022-12-13 19:26:09",
			"activateTime": "2023-10-07 00:00:00",
			"expireTime": "2023-10-07 00:00:00",
			"newActivateTime": null,
			"orgCode": "42",
			"yktCardModel": {
				"createTime": "2022-12-13 19:26:09",
				"updateTime": "2022-12-16 22:29:21",
				"id": 15,
				"name": null,
				"price": 300,
				"marketPrice": 300,
				"autoActiveDayAfterBuy": null,
				"periodOfValidity": null,
				"cover": null,
				"filmOrderTimes": null,
				"cardMaxBuyCount": null,
				"article": null
			},
			"expendTime": "2023-10-06T16:00:00.000+00:00",
			"expendRemark": "为HVzrP3F87dAroE6f续费!"
		}
	}
}

失败 code=201

{
	"msg": "已激活卡只能续费过期的卡",
	"code": 500
}
示例来自源码/导出内容,仅结构参考,非线上真实数据。

附录 · 实现细节

外部平台接口,本仓库无对应实现:与 jxxx-dscp 的接口路径尾段交叉比对为 0 条,请勿与本仓库接口混用。本系统开放与对接接口 →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写,均来自同一份数据