POST/yikatongApi/card/provide外部平台

旅游卡发卡

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

基本信息

接口状态已完成来自 Apipost 导出，非本仓库代码
接口URLPOSThttps://card.ssykt.cn/yikatongApi/card/provide
请求方式POST
Content-Typeurlencoded
调用方外部平台接口，由本系统服务端调用（不在 7 端前端扫描范围）
所属分组旅游卡模块
来源三省一卡通平台 Apipost 导出（原始页）
接口说明旅游卡发卡，创建发卡队列，返回队列id，根据id查询执行结果和发卡信息

请求参数

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
token	eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJVU0VSX0xPR0lOIjoiMTUyNzMzMjIyOTkiLCJleHAiOjE2Nzc2NTgyNzN9.22lk6hxU2SvBuzHNbXZgu-yPbFRlApCMHfGX99B8LJM	是	String	请求token

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 模式：urlencoded

参数名	参数值	是否必填	参数类型	描述说明
userId	2	是	String	用户user_id
orgCode	43	是	String	组织编码（00-母平台，36-江西，42-湖北，43-湖南）
cardNum	3	是	Integer	发卡数量

认证方式

认证方式：noauth（导出未标注具体鉴权，需与对方确认）

响应参数

参数名	参数值	是否必填	参数类型	描述说明
导出内容未提供响应字段表，见下方响应示例

响应示例

成功 code=200

{
	"msg": "操作成功",
	"code": 0,
	"data": [
		{
			"createTime": "2023-03-02T16:00:00.000+00:00",
			"updateTime": "2023-03-07T01:47:48.723+00:00",
			"id": 1698,
			"modelId": 1,
			"cardBatchId": 28,
			"number": "43000100000003",
			"activeCode": "073248",
			"marketPrice": 199,
			"price": 0.01,
			"status": 1,
			"bindStatus": 0,
			"bindTime": null,
			"buyTime": "2023-03-07T01:47:48.723+00:00",
			"buyerId": 2,
			"autoActivateTime": "2023-06-04T16:00:00.000+00:00",
			"ownerId": null,
			"channel": null,
			"activateTime": null,
			"expireTime": null,
			"orgCode": "43",
			"yktCardModel": {
				"createTime": "2023-03-02T16:00:00.000+00:00",
				"updateTime": "2023-03-02T16:00:00.000+00:00",
				"id": 1698,
				"name": null,
				"price": 0.01,
				"marketPrice": 199,
				"autoActiveDayAfterBuy": null,
				"periodOfValidity": null,
				"cover": null,
				"filmOrderTimes": null,
				"cardMaxBuyCount": null
			}
		},
		{
			"createTime": "2023-03-02T16:00:00.000+00:00",
			"updateTime": "2023-03-07T01:47:48.723+00:00",
			"id": 1699,
			"modelId": 1,
			"cardBatchId": 28,
			"number": "43000100000004",
			"activeCode": "518229",
			"marketPrice": 199,
			"price": 0.01,
			"status": 1,
			"bindStatus": 0,
			"bindTime": null,
			"buyTime": "2023-03-07T01:47:48.723+00:00",
			"buyerId": 2,
			"autoActivateTime": "2023-06-04T16:00:00.000+00:00",
			"ownerId": null,
			"channel": null,
			"activateTime": null,
			"expireTime": null,
			"orgCode": "43",
			"yktCardModel": {
				"createTime": "2023-03-02T16:00:00.000+00:00",
				"updateTime": "2023-03-02T16:00:00.000+00:00",
				"id": 1699,
				"name": null,
				"price": 0.01,
				"marketPrice": 199,
				"autoActiveDayAfterBuy": null,
				"periodOfValidity": null,
				"cover": null,
				"filmOrderTimes": null,
				"cardMaxBuyCount": null
			}
		},
		{
			"createTime": "2023-03-02T16:00:00.000+00:00",
			"updateTime": "2023-03-07T01:47:48.723+00:00",
			"id": 1700,
			"modelId": 1,
			"cardBatchId": 28,
			"number": "43000100000005",
			"activeCode": "174656",
			"marketPrice": 199,
			"price": 0.01,
			"status": 1,
			"bindStatus": 0,
			"bindTime": null,
			"buyTime": "2023-03-07T01:47:48.723+00:00",
			"buyerId": 2,
			"autoActivateTime": "2023-06-04T16:00:00.000+00:00",
			"ownerId": null,
			"channel": null,
			"activateTime": null,
			"expireTime": null,
			"orgCode": "43",
			"yktCardModel": {
				"createTime": "2023-03-02T16:00:00.000+00:00",
				"updateTime": "2023-03-02T16:00:00.000+00:00",
				"id": 1700,
				"name": null,
				"price": 0.01,
				"marketPrice": 199,
				"autoActiveDayAfterBuy": null,
				"periodOfValidity": null,
				"cover": null,
				"filmOrderTimes": null,
				"cardMaxBuyCount": null
			}
		}
	]
}

失败 code=201

{
	"msg": "必选参数为空",
	"code": 500
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

外部平台接口，本仓库无对应实现：与 jxxx-dscp 的接口路径尾段交叉比对为 0 条，请勿与本仓库接口混用。本系统开放与对接接口 →