改进文档格式
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md" "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
index b436226..c7e2e90 100644
--- "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
+++ "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -17,53 +17,57 @@
## 接口定义
### 1. 查询银行卡余额
-> URL: /bankservice/bankquery
-> 请求方式 GET/POST
+* **URL: /bankservice/bankquery**
+
+* **请求方式**
+`GET`, `POST`
查询银行余额，根据银行实际情况不是所有银行都支持
-> 请求
+* **请求**
+`bankaccount` - 银行账号
+`custname` - 用户名，必须是该用户在银行的开户名（可选）
+`stuempno` - 学工号，可选
+`termid` - 发起终端号
+`tradetime` - 发起方时间，格式 yyyyMMddHHmmss
+`seqno` - 发起方流水号（可选）
+`timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-* bankaccount - 银行账号
-* custname - 用户名，必须是该用户在银行的开户名（可选）
-* stuempno - 学工号，可选
-* termid - 发起终端号
-* tradetime - 发起方时间，格式 yyyyMMddHHmmss
-* seqno - 发起方流水号（可选）
-* timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-
-> 返回
+* **返回**
+`ret` - "00"标识操作成功，其余为异常情况
+`retmsg` - 返回信息
+`money` - 银行卡余额，单位元
```json
{
- ret:"00",
- retmsg:"msg", // 异常原因
- money:12.3 //单位（元）
+ "ret":"00",
+ "retmsg":"msg", // 异常原因
+ "money":12.3 //单位（元）
}
```
-* ret - "00"标识操作成功，其余为异常情况
-* retmsg - 返回信息
-* money - 银行卡余额，单位元
-
-
### 2. 圈存请求
-> URL: /bankservice/load
-> 请求方式 POST
+* **URL: /bankservice/load**
+
+* **请求方式**
+`POST`
银行圈存请求，通过该请求完成银行卡转账业务
-> 请求
-* bankaccount - 银行卡号
-* seqno - 悦校/一卡通交易参考号
-* stuempno - (可选）学工号
-* custname - (可选）客户姓名
-* amount - 圈存金额，单位元
-* termid - （可选）终端编号
-* tradetime - 请求时间， 格式yyyyMMddHHmmss
-* timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
+* **请求**
+`bankaccount` - 银行卡号
+`seqno` - 悦校/一卡通交易参考号
+`stuempno` - (可选）学工号
+`custname` - (可选）客户姓名
+`amount` - 圈存金额，单位元
+`termid` - （可选）终端编号
+`tradetime` - 请求时间， 格式yyyyMMddHHmmss
+`timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-> 返回
+* **返回**
+`ret` - "00"标识操作成功，其余为异常情况
+`bankseqno` - （可选）返回银行端流水号，但不是所有银行都支持返回银行端流水号
+`retmsg` - 返回信息
```json
{
@@ -73,30 +77,29 @@
}
```
-* ret - "00"标识操作成功，其余为异常情况
-* bankseqno - （可选）返回银行端流水号，但不是所有银行都支持返回银行端流水号
-* retmsg - 返回信息
-
-
### 3. 圈存结果查询
-> URL: /bankservice/transquery
-> 请求方式 GET/POST
+* **URL: /bankservice/transquery**
+
+* **请求方式**
+`GET`, `POST`
查询圈存请求的结果，一般是圈存请求超时后通过这个接口判断银行交易是否成功，但不是所有银行都支持这个接口
-> 请求
+* **请求**
+`bankaccount` - 银行卡号
+`seqno` - 悦校/一卡通交易参考号
+`loadseqno` - 前一笔圈存交易的参考号
+`stuempno` - (可选）学工号
+`custname` - (可选）客户姓名
+`amount` - 圈存金额，单位元
+`termid` - （可选）终端编号
+`tradetime` - 请求时间， 格式yyyyMMddHHmmss
+`timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-* bankaccount - 银行卡号
-* seqno - 悦校/一卡通交易参考号
-* loadseqno - 前一笔圈存交易的参考号
-* stuempno - (可选）学工号
-* custname - (可选）客户姓名
-* amount - 圈存金额，单位元
-* termid - （可选）终端编号
-* tradetime - 请求时间， 格式yyyyMMddHHmmss
-* timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-
-> 返回
+* **返回**
+`ret` - "00" 标识查询到指定的圈存流水，"01" 标识无指定流水，其它表示错误
+`bankseqno` - （可选）如果查询到圈存流水则返回银行端流水号，但不是所有银行都支持返回银行端流水号
+`retmsg` - 返回信息
```json
{
@@ -106,29 +109,29 @@
}
```
-* ret - "00" 标识查询到指定的圈存流水，"01" 标识无指定流水，其它表示错误
-* bankseqno - （可选）如果查询到圈存流水则返回银行端流水号，但不是所有银行都支持返回银行端流水号
-* retmsg - 返回信息
-
-
### 4. 圈存冲正
-> URL: /bankservice/loadcancel
-> 请求方式 GET/POST
+* **URL: /bankservice/loadcancel**
+
+* **请求方式**
+`GET`, `POST`
圈存冲正接口，一般是圈存请求超时后通过这个接口冲正前面一笔圈存交易，但不是所有银行都支持这个接口
-> 请求
-* bankaccount - 银行卡号
-* seqno - 悦校/一卡通交易参考号
-* loadseqno - 前一笔圈存交易的参考号
-* stuempno - (可选）学工号
-* custname - (可选）客户姓名
-* amount - 圈存金额，单位元
-* termid - （可选）终端编号
-* tradetime - 请求时间， 格式yyyyMMddHHmmss
-* timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
+* **请求**
+`bankaccount` - 银行卡号
+`seqno` - 悦校/一卡通交易参考号
+`loadseqno` - 前一笔圈存交易的参考号
+`stuempno` - (可选）学工号
+`custname` - (可选）客户姓名
+`amount` - 圈存金额，单位元
+`termid` - （可选）终端编号
+`tradetime` - 请求时间， 格式yyyyMMddHHmmss
+`timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-> 返回
+* **返回**
+`ret` - "00" 标识冲正成功，其它表示错误
+`bankseqno` - （可选）返回银行端流水号，但不是所有银行都支持返回银行端流水号
+`retmsg` - 返回信息
```json
{
@@ -139,6 +142,4 @@
```
-* ret - "00" 标识冲正成功，其它表示错误
-* bankseqno - （可选）返回银行端流水号，但不是所有银行都支持返回银行端流水号
-* retmsg - 返回信息
+
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\350\200\203\345\213\244\346\234\272\346\216\245\345\217\243\346\226\207\346\241\243.md" "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\350\200\203\345\213\244\346\234\272\346\216\245\345\217\243\346\226\207\346\241\243.md"
index d7e4ebd..3531c87 100644
--- "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\350\200\203\345\213\244\346\234\272\346\216\245\345\217\243\346\226\207\346\241\243.md"
+++ "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\350\200\203\345\213\244\346\234\272\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -28,41 +28,43 @@
## 接口定义
### 1. 心跳
-> URL: /v4/attendance/heartbeat/{deviceid}
-> 请求方式: GET, POST
+* **URL: /v4/attendance/heartbeat/{deviceid}**
+
+* **请求方式**
+`GET`, `POST`
考勤设备心跳请求, 设备一般每 1 分钟发送一次心跳请求
-> 请求参数
+* **请求参数**
+`device_time` - 设备时间，格式 YYYYMMDDHHMISS, 例如 20150318133454
+`software_version` - 考勤机软件版本，字符串
-* device_time - 设备时间，格式 YYYYMMDDHHMISS, 例如 20150318133454
-* software_version - 考勤机软件版本，字符串
-
-> 应答
+* **应答**
```json
{"sys_time": }
```
-* sys_time - 系统当前时间，格式 YYYYMMDDHHMISS
-* version - 系统版本号，格式整数
+`sys_time` - 系统当前时间，格式 YYYYMMDDHHMISS
+`version` - 系统版本号，格式整数
### 2. 脱机考勤流水上传
-> URL: /v4/attendance/uploadrecord/{deviceid}
-> 请求方式: POST, PUT
+* **URL: /v4/attendance/uploadrecord/{deviceid}**
+
+* **请求方式**
+`POST`, `PUT`
考勤设备上传脱机流水, 每次上传的流水笔数不能超过 20 条
-> 请求参数
+* **请求参数**
+`record_count` - 上传流水笔数, 这个参数必须在URL中
-* record_count - 上传流水笔数, 这个参数必须在URL中
-
-> 请求头
+* **请求头**
请求报文的 Content-Type 必须为 text/plain
-> 请求 body
+* **请求 body**
上传流水数据， JSON encoded 格式，例子如下:
@@ -83,59 +85,64 @@
]
```
-> 应答
+* **应答**
```json
{"record_count": <record_count>}
```
### 3. 脱机记录上传（带照片）
-> URL: /v4/attendance/uploadrecordwithpic/{deviceid}
-> 请求方式: POST, PUT
+* **URL: /v4/attendance/uploadrecordwithpic/{deviceid}**
+
+* **请求方式**
+`POST`, `PUT`
考勤设备上传脱机
-> 请求参数
-
-* termdate - 刷卡日期，格式 YYYYMMDD
-* termtime - 刷卡时间, 格式 HHMISS
-* cardphyid - 物理卡号，例如 DB3412FF
-* devseqno - 考勤设备流水号
+* ** URL参数**
+`termdate` - 刷卡日期，格式 YYYYMMDD
+`termtime` - 刷卡时间, 格式 HHMISS
+`cardphyid` - 物理卡号，例如 DB3412FF
+`devseqno` - 考勤设备流水号
以上参数必须在 URL 中上传
-> 请求头
+* **请求头**
请求报文的 Content-Type 必须为 application/octet-stream
-> 请求 body
+* **请求 body**
上传照片文件的内容，采用二进制流传输
-> 应答
+* **应答**
+无
### 4. 联机认证
-> URL: /v4/attendance/onlinecheck/{deviceid}
-> 请求方式: POST, PUT
+* **URL: /v4/attendance/onlinecheck/{deviceid}**
+
+* **请求方式**
+`POST`, `PUT`
考勤设备联机考勤
-> 请求参数
+* **请求参数**
+`termdate` - 刷卡日期，格式 YYYYMMDD
+`termtime` - 刷卡时间, 格式 HHMISS
+`cardphyid` - 物理卡号，例如 DB3412FF
+`devseqno` - 考勤设备流水号
-* termdate - 刷卡日期，格式 YYYYMMDD
-* termtime - 刷卡时间, 格式 HHMISS
-* cardphyid - 物理卡号，例如 DB3412FF
-* devseqno - 考勤设备流水号
-
-> 应答
+* **应答**
```json
{"result": "failed",
- "message": "不在考勤时间段"}
+ "message": "不在考勤时间段",
+ "stuempno": "2015001",
+ "custname": "张三"}
```
-返回参数定义
+* **返回参数定义**
| 参数名 | 定义 |
|:--------- |:---------------------------------------|
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232\350\257\273\345\215\241\346\234\215\345\212\241\346\216\245\345\217\243\346\226\207\346\241\243.md" "b/source/_posts/\344\270\200\345\215\241\351\200\232\350\257\273\345\215\241\346\234\215\345\212\241\346\216\245\345\217\243\346\226\207\346\241\243.md"
index b7bf236..35664ac 100644
--- "a/source/_posts/\344\270\200\345\215\241\351\200\232\350\257\273\345\215\241\346\234\215\345\212\241\346\216\245\345\217\243\346\226\207\346\241\243.md"
+++ "b/source/_posts/\344\270\200\345\215\241\351\200\232\350\257\273\345\215\241\346\234\215\345\212\241\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -4,7 +4,7 @@
tags:
---
-* **version : 1.4**
+* **version : 1.5**
## 错误码定义
* 100 - 一般错误
@@ -420,7 +420,7 @@
`GET`
* **Url 参数**
-`action`: 可选参数包括 publishkeycard, clonekeycard, loadkeycard
+`action`: 可选参数包括 publishkeycard, clonekeycard, loadkeycard, dumpkeys
* **请求参数**
`publishkeycard`: 发行密钥卡
@@ -433,6 +433,32 @@
`loadkeycard`: 加载密钥卡
> pin - PIN 码
+ `dumpkeys`: 保存密钥
+ > pin - PIN 码
+
* **返回**
-无
+`dumpkeys`: 读取密钥
+> keys - 返回密钥串
+
+## 发行、读取、回收水控参数卡
+* **URL: /4/waterparamcard/<action>**
+* **请求方式**
+`GET`
+
+* **Url 参数**
+`action`: 可选值 write, read, recycle
+
+* **请求参数**
+`write`: 发行水控卡时
+> water_flag: 水控卡标志
+> packget_num: 水控钱包号
+> main_work_key: 主钱包密钥
+> packget_work_key: 水控钱包密钥
+> work_mode: 水控模式
+> water_packet_limit: 水控钱包上限
+> feecfg: [{"feetype": 3, "rate": [{"start": 0, "deduct_time":10, "deduct_fee": 5}, {"start": 5, "deduct_time":15, "deduct_fee": 5}]}]
+> transfer_limit: 水控转账限额
+
+ `read`: 读取水控参数卡
+ `recycle`: 回收水控参数卡