项目概览
项目简介
基于PHP实现的一卡通平台API接口服务，提供账户查询、交易流水、商户管理、门禁考勤、银行转账等功能。系统采用RESTful设计风格，支持GET和POST两种请求方式，返回JSON格式数据。
服务信息
50+
API接口
14
功能模块
RESTful
设计风格
基础信息
服务地址
http://10.72.28.19/ykt-api/
请求方式
支持 GET 和 POST 请求，参数可通过 URL 参数或 JSON 格式传递。
返回格式
{
"code": "0",
"msg": "请求成功",
"data": {
// 返回数据
}
}错误码说明
| 返回码 | 说明 |
|---|---|
| 0 | 请求成功 |
| -1 | 系统繁忙，具体看错误消息 |
| 1 | 签名无效 |
| 2 | 多种验证错误 |
| 10001 | 系统权限认证服务错误 |
| 10002 | 系统签名服务错误 |
| 30000 | 无效参数 |
| 30001 | 缺少签名参数 |
| 40001 | appId无效 |
| 40002 | appSecret错误 |
| 41001 | 账户不存在 |
| 41002 | 卡片不存在 |
| 41009 | 订单不存在 |
数据字典
账户状态 (accStatus)
| 编号 | 名称 |
|---|---|
| -2 | 申请开户 |
| -1 | 预开户 |
| 0 | 销户 |
| 1 | 有效 |
| 3 | 冻结 |
| 4 | 预销户 |
| 98 | 冻结充值 |
| 99 | 失效（过有效期） |
人员类别 (accType)
| 编号 | 名称 |
|---|---|
| 1 | 学生 |
| 2 | 教工 |
| 3 | 其他人员 |
| 4 | 临时人员 |
卡片状态 (cardStatus)
| 编号 | 名称 |
|---|---|
| 0 | 销卡 |
| 1 | 有效 |
| 2 | 挂失 |
| 3 | 冻结 |
| 4 | 预销卡 |
| 5 | 锁卡 |
交易大类 (transferType)
| 编号 | 名称 |
|---|---|
| 1 | 操作类 |
| 2 | 消费类 |
| 3 | 充值类 |
| 4 | 补助类 |
渠道类型 (compareType)
| 编号 | 名称 |
|---|---|
| 1 | 支付宝 |
| 2 | 微信 |
| 6 | 银联 |
| 9 | 校园卡 |
| 13 | 农业银行 |
签名指南
签名算法
1. 将所有参数按照参数名ASCII码从小到大排序（字典序）
2. 拼接成字符串stringA（参数名不参与排序，直接拼接到尾部）
3. 对stringSignTemp进行MD5加密并转大写得到sign
示例
// 请求参数 accNum=2&amount=100.00&cardAccNum=2 // 拼接appid stringSignTemp="accNum=2&amount=100.00&cardAccNum=2&key=123456" // 生成签名 sign=MD5(stringSignTemp).toUpperCase()
