Skip to content

Z
zhichan
Commit e3dfeb19 by 宋毅
Options

tj

parent 1a476812
Showing with 233 additions and 675 deletions
igirl-channel/app/config/routes/doc.js
...@@ -34,7 +34,7 @@ module.exports = function (app) { ...@@ -34,7 +34,7 @@ module.exports = function (app) {
}); });
}); });
app.get('/doc/:forder/:fileName', function (req, res) { app.get('/doc/api/:forder/:fileName', function (req, res) {
var forder = req.params["forder"]; var forder = req.params["forder"];
var fileName = req.params["fileName"] || "README.md"; var fileName = req.params["fileName"] || "README.md";
var path = process.cwd() + "/app/front/entry/public/apidoc"; var path = process.cwd() + "/app/front/entry/public/apidoc";
......
igirl-channel/app/front/entry/apidoc.ejs
...@@ -10,12 +10,12 @@ ...@@ -10,12 +10,12 @@
</head> </head>
<body > <body>
<div style="width:100%;text-align: center;font-size: 20px;"> <div style="width:100%;text-align: center;font-size: 20px;">
薪果果个体工商户API文档 渠道接入API文档
</div> </div>
<div class="markdown-body" style="margin-left:40px;" id="doc-page"> <div class="markdown-body" style="margin-left:40px;" id="doc-page">
<%- str%> <%- str%>
</div> </div>
</body> </body>
......
igirl-channel/app/front/entry/public/apidoc/README.md
## 1. 调用接口需要开通app应用
　　1 [获取app信息](doc/api/appDesc/demoDesc.md)
## 1. 用户相关接口 　　2 [获取token信息](doc/api/appDesc/demoDesc.md)
　　1 [用户中心](doc/user/user.md)
## 2. 商户相关接口 　　3 [通用接口示例](doc/api/appDesc/demoDesc.md)
　　1 [商户接口](doc/merchant/merchant.md)
## 2. 订单相关接口
　　1 [订单](doc/order/order.md)
　　2 [个体工商户](doc/order/businessmen.md)
## 3. 发票接口
　　1 [发票](gongsibao-er/README.md)
## 2. 商标操作相关接口
　　1 [商标操作中心](doc/api/opTrademark/opTm.md)
## 3. 商标检索相关接口
　　1 [商标检索中心](doc/api/opTrademark/opTm.md)
igirl-channel/app/front/entry/public/apidoc/appDesc/demoDesc.md 0 → 100644
<a name="menu" href="/doc">返回主目录</a>
1. [开通app参数](#appParams)
1. [获取token](#getToken)
1. [通用接口示例](#demo)
## **<a name="appParams"> 开通app参数</a>**
[返回到目录](#menu)
#### 请求接口之前需要向合作方获取如下参数：
#### appkey：2019090811
#### secret：f99d413b767f09b5dff0b3610366cc46
#### 参数说明：appkey、secret为获取请求头token的参数。
## **<a name="getToken"> 获取token</a>**
[返回到目录](#menu)
##### URL
[/auth/accessAuth/getToken]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"appkey": "2019090811", //Y string appkey
"secret": "f99d413b767f09b5dff0b3610366cc46"//Y string 密钥
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"token": "40d64e586551405c9bcafab87266bc04" //token用于其他接口请求时，放在请求头中
},
"requestId": "2016c54abe7249a2a1195d236b333f79"
}
```
## **<a name="demo"> 通用接口示例</a>**
[返回到目录](#menu)
##### URL
[/auth/accessAuth]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
所有请求接口在请求前，必须获取token，并把token放在请求头Headers中，无特殊说明请求方式统一为POST请求。
通用请求接口示例：
请求头中需要传递的参数：token、request-id
请求参数：
{
"actionProcess": "jd", //Y string 执行的渠道名称
"actionType": "demo", //Y string 渠道执行的类型
"actionBody": { //N JSON 要传递的body信息
"userId": "019101116473600000", //N string 用户ID
"userName": "张三" //N string 用户名称
}
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"opDesc": "京东云合作"
},
"requestId": "2016c54abe7249a2a1195d236b333f79"
}
返回值参数说明：
status 返回状态，0为成功，否则为失败
msg 成功或失败信息描述
data 接口返回的数据信息
requestId 请求头中的request-id，作为接口调用跟踪
```
igirl-channel/app/front/entry/public/apidoc/merchant/merchant.md deleted 100644 → 0
<a name="menu">目录</a>
1. [商户nameList](#nameList)
1. [新增/修改商户](#saveMerchant)
1. [商户列表](#merchantList)
1. [商户审核](#merchantAudit)
1. [商户签约](#merchantSign)
1. [查看签约](#showSign)
1. [签约列表](#signList)
1. [资金账户列表](#accountList)
1. [充值申请列表](#rechargeList)
1. [充值申请审核](#rechargeAudit)
1. [资金交易列表](#tradeList)
1. [资金流水列表](#processList)
## **<a name="nameList"> 商户nameList</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantCtl/nameList]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": [
{
"id": 110361382269, // 商户id
"name": "司机宝" // 商户名称
},
{
"id": 110361384474,
"name": "测试公司录入1"
},
{
"id": 110361384475,
"name": "测试公司录入3"
},
{
"id": 110361384476,
"name": "546444544"
}
]
}
```
## **<a name="saveMerchant"> 新增/修改商户</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantCtl/saveMerchant]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"id": 110361384475, // 商户id，新增时为0, 修改时为当前修改的商户id
"name": "测试公司录入3", // 商户名称
"taxType": 1, // 纳税人类型 0一般纳税人 1小规模纳税人
"contactName": "宋毅", // 联系人姓名
"contactMobile": "13338383838", // 联系人手机
"contactEmail": "songyi@gongisbao.com", // 联系人邮箱
"taxNo": "sssssssss", // 纳税人识别号
"invoiceAddr": "朝来高科技产业园33333", // 开票地址
"invoiceMobile": "13838383838", // 开票电话
"accountName": "宋毅", // 开户名称
"accountPublic": "xxxx对公账户22222", // 对公账户
"mailAddr": "来广营", // 邮寄地址
"mailTo": "宋小毅", // 收件人
"mailMobile": "13838383838", // 收件电话
"ownerName": "宋大毅", // 客户经理姓名
"ownerMobile": "13838383838", // 客户经理电话
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success"
}
```
## **<a name="merchantList"> 商户列表</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantCtl/allList]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"currentPage": 1, // 当前页
"pageSize": 10, // 每页显示条数
"name": "测试公司", // 公司名称
"merchantId": 11111, // 商户id
"createdBegin": "", // 创建时间-开始
"createdEnd": "" // 创建时间-结束
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"count": 1, // 总数
"rows": [ // 商户列表
{
"id": 110361384475, // 商户id
"name": "测试公司录入3", // 商户名称
"taxType": 1, // 纳税人类型 0一般纳税人 1小规模纳税人
"contactName": "宋毅", // 联系人姓名
"contactMobile": "13338383838", // 联系人手机
"contactEmail": "songyi@gongisbao.com", // 联系人邮箱
"taxNo": "sssssssss", // 纳税人识别号
"invoiceAddr": "朝来高科技产业园33333", // 开票地址
"invoiceMobile": "13838383838", // 开票电话
"accountName": "宋毅", // 开户名称
"accountPublic": "xxxx对公账户22222", // 对公账户
"mailAddr": "来广营", // 邮寄地址
"mailTo": "宋小毅", // 收件人
"mailMobile": "13838383838", // 收件电话
"ownerName": "宋大毅", // 客户经理姓名
"ownerMobile": "13838383838", // 客户经理电话
"statusName": "待审核" // 商户状态名称
"status": 0, // 商户状态 0待审核 1待签约 2签约完成
"created_at": "2019-09-23 08:00", // 创建时间
},
]
}
}
```
## **<a name="merchantAudit"> 商户审核</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantCtl/merchantAudit]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"id": 110361382269, // 商户id
"ucname": "18600002222" // 商户登录帐号
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success"
}
```
## **<a name="merchantSign"> 添加/修改签约</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantsignedCtl/merchantSign]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"merchant_id": 110361382269, // 商户id
"nameA": "xxxxx有限公司", // 签约主体
"contractNo": "NO233332222", // 合同编码
"beginDate": "2019-08-22", // 合同开始时间
"endDate": "2020-08-22", // 合同结束时间
"serviceRate": "5.23", // 服务费率
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success"
}
```
## **<a name="showSign"> 查看签约</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantsignedCtl/showSign]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"merchant_id": 110361384474
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"merchant": {
"id": 110361384475, // 商户id
"name": "测试公司录入3", // 商户名称
},
"merchantSign": {
"merchant_id": 110361384474, // 商户id
"nameA": "xxxxx有限公司", // 签约主体
"contractNo": "NO233332222", // 合同编码
"beginDate": "2019-08-22T00:00:00.000Z", // 合同开始时间
"endDate": "2020-08-22T00:00:00.000Z", // 合同结束时间
"serviceRate": 5.23, // 服务费率
"created_at": "2019-09-23T12:08:38.000Z", // 创建时间
}
}
}
```
## **<a name="signList"> 签约列表</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantsignedCtl/signList]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"currentPage": 1, // 页码
"pageSize": 10, // 每页条数
"merchantId": 11111, // 商户id
"merchantName": "" // 商户名称
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"count": 2,
"rows": [
{
"merchant": {
"id": 110361384475, // 商户id
"name": "测试公司录入3", // 商户名称
},
"merchantSign": {
"merchant_id": 110361384474, // 商户id
"nameA": "xxxxx有限公司", // 签约主体
"contractNo": "NO233332222", // 合同编码
"beginDate": "2019-08-22T00:00:00.000Z", // 合同开始时间
"endDate": "2020-08-22T00:00:00.000Z", // 合同结束时间
"serviceRate": 5.23, // 服务费率
"created_at": "2019-09-23T12:08:38.000Z", // 创建时间
}
},
]
}
}
```
## **<a name="accountList"> 资金账户</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantaccountCtl/accountList]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"currentPage": 1, // 页码
"pageSize": 10, // 每页条数
"merchantName": "" // 商户名称
"merchantId": "" // 商户id
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"count": 1,
"rows": [
{
"id": 1,
"merchant_id": 110361382269, // 商户id
"frozen_amt": 120512852, // 冻结金额
"frozen_amt_y": "1205128.52", // 冻结金额（元）
"available_amt": 4879475646, // 可用金额
"available_amt_y": "48794756.46 " // 可用余额（元）
"created_at": "2019-09-10 13:27", // 创建时间
"merchantName": "司机宝", // 企业名称
}
]
}
}
```
## **<a name="rechargeList"> 充值申请列表</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantrechargeCtl/rechargeList]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"currentPage": 1,
"pageSize": 10,
"merchantName": " ", // 商户名称
"merchantId": "" // 商户id
"createdBegin": "", // 创建时间-开始
"createdEnd": "", // 创建时间-结束
"status": null // 状态 0待审核 1已入账 2审核失败
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"count": 2,
"rows": [
{
"id": 1, // id, 审核时候传入
"merchant_id": 110361382269, // 商户id
"outTradeNo": "2", // 充值流水号
"voucher": "https://www.baidu.com/1.png", // 充值凭证
"amt": 100000, // 充值金额（分）
"amt_y": "1000", // 充值金额（元）
"statusName": "待审核", // 审核状态名称
"status": 0, // 审核状态
"remark": "", // 审核备注
"merchantName": "司机宝" // 商户名称
"auditUserName": "样情局" // 审核人
},
]
}
}
```
## **<a name="rechargeAudit"> 充值申请审核</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchantrechargeCtl/rechargeAudit]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"id": 3, // 充值id
"status": 1, // 审核状态 1已入账 2审核失败
"remark": "审核备注" // 审核备注 审核失败时必须填写
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
}
```
## **<a name="tradeList"> 资金交易列表</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchanttradeCtl/tradeList]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"currentPage": 1,
"pageSize": 10,
"merchantId":"", // 商户id
"invoiceApplyNo":"456456", // 发票申请号
"type":"", // 收支类型 1充值 2支出
"createdBegin":"", // 创建时间-开始
"createdEnd":"" // 创建时间-结束
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"count": 1,
"rows": [
{
"id": 7, // id
"merchant_id": 110361382269, // 商户id
"merchantName": "司机宝", // 商户名称
"invoiceNo": "123123", // 发票编号
"invoiceApplyNo": "456456", // 发票申请号
"outTradeNo": "2", // 充值流水号
"amt": 100000, // 交易金额（分）
"amt_y": "1000" // 交易金额（元）
"balance": 4879525646, // 账户余额
"type": 2, // 收支类型 1充值 2支出
"businessTypeName": "增值费扣款", // 业务类型名称
"businessType": 20, // 业务类型 00服务费扣款 10个税扣款 20增值费扣款 30附加费扣款 90充值入账
"created_at": "2019-09-24 11:41", // 创建时间
}
]
}
}
```
## **<a name="processList"> 资金流水列表</a>**
[返回到目录](#menu)
##### URL
[/web/merchant/merchanttradeprocessCtl/processList]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
``` javascript
{
"currentPage": 1,
"pageSize": 10,
"merchantId":"", // 商户id
"invoiceApplyNo":"456456", // 发票申请号
"busiType":"", // 业务类型 00开票冻结 10解冻扣款 20撤回发票退款 30审核驳回退款
"createdBegin":"", // 创建时间-开始
"createdEnd":"" // 创建时间-结束
}
```
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"count": 4,
"rows": [
{
"id": 50, // id
"merchant_id": 110361382269, // 商户id
"merchantName": "司机宝", // 商户名号曾
"invoiceApplyNo": "100002", // 发票申请号
"amtType": "30", // 费用类型 00服务费 10个税 20增值费 30附加费
"amtTypeName": "附加费", // 费用类型名称
"amt": 0, // 流水金额（分）
"amt_y": "0", // 流水金额（元）
"frozen_amt": 120519881, // 账户冻结金额（分）
"frozen_amt_y": "1205198.81", // 账户冻结金额（元）
"available_amt": 4879468617, // 账户可用余额（分）
"available_amt_y": "48794686.17" // 账户可用余额（元）
"busiType": "00", // 业务类型 00开票冻结 10解冻扣款 20撤回发票退款 30审核驳回退款
"busiTypeName":"解冻扣款", // 业务类型名称
"created_at": "2019-09-20 03:16", // 创建时间
},
]
}
}
```
igirl-channel/app/front/entry/public/apidoc/opTrademark/opTm.md 0 → 100644
<a name="menu" href="/doc">返回主目录</a>
1. [尼斯查询（一）](#getNcl)
1. [尼斯查询（二）](#getNclTwo)
## **<a name="getNcl"> 尼斯查询（一）</a>**
[返回到目录](#menu)
##### URL
[/action/tmTools/springBoard]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
#### actionType：getNcl
``` javascript
{
"nclcode": "01" //Y string 尼斯编号（尼斯大类类别获取群组类别）
}
```
#### 返回结果
```javascript
{
"status": 0,//操作状态0:操作成功-1:操作失败
"msg": "操作成功",//操作信息
"data": [
{
"code": "01",//尼斯大类编码
"name": "",//大类名称
"pcode": "",//父类编码 大类要为父类则为空
"type": 1,
"children": [//尼斯群组信息
{
"code": "0106",//群组编码
"name": "化学试剂",//群组名称
"pcode": "01",//群组父类编码 即其所属大类编码
"type": 1,
"children": [//尼斯小类
{
"code": "010122",//小类编码
"name": "生物化学催化剂",//小类名称
"pcode": "0106"//小类父类编码 即其所属群组编码
}
]
}
]
},
{
"code": "42",
"name": "",
"pcode": "",
"type": 1,
"children": [
{
"code": "4211",
"name": "提供化学研究服务",
"pcode": "42",
"type": 1,
"children": [
{
"code": "",
"name": "生物化学研究和分析",
"pcode": "4211"
}
]
}
]
}
],
"requestId": "8cd7e91ec607453c805da8302f3e068c"
}
```
## **<a name="getNclTwo"> 尼斯查询（二）</a>**
[返回到目录](#menu)
##### URL
[/action/tmTools/springBoard]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
#### actionType：getNcl
``` javascript
{
"name": "生物化学",//Y strin 尼斯名称
"ncls ": ["01"]//N List 尼斯大类编码列表
}
```
#### 返回结果
```javascript
{
"status": 0,//操作状态0:操作成功-1:操作失败
"msg": "操作成功",//操作信息
"data": [
{
"code": "01",//尼斯大类编码
"name": "",//大类名称
"pcode": "",//父类编码 大类要为父类则为空
"type": 1,
"children": [//尼斯群组信息
{
"code": "0106",//群组编码
"name": "化学试剂",//群组名称
"pcode": "01",//群组父类编码 即其所属大类编码
"type": 1,
"children": [//尼斯小类
{
"code": "010122",//小类编码
"name": "生物化学催化剂",//小类名称
"pcode": "0106"//小类父类编码 即其所属群组编码
}
]
}
]
},
{
"code": "42",
"name": "",
"pcode": "",
"type": 1,
"children": [
{
"code": "4211",
"name": "提供化学研究服务",
"pcode": "42",
"type": 1,
"children": [
{
"code": "",
"name": "生物化学研究和分析",
"pcode": "4211"
}
]
}
]
}
],
"requestId": "8cd7e91ec607453c805da8302f3e068c"
}
```
igirl-channel/app/front/entry/public/apidoc/user/user.md deleted 100755 → 0
<a name="menu">目录</a>
1. [图片验证码](#captcha)
1. [短信验证码](#smsCode)
1. [登录](#login)
1. [当前用户信息查询](#loginUser)
1. [获取菜单](#getMenu)
## **<a name="captcha"> 图片验证码</a>**
[返回到目录](#menu)
##### URL
[/web/auth/userCtl/captcha]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
| 参数 | 必选 | 类型 | 说明|
| -------- | -------- | ------------|---------|
| **width** | 否 | int | 图片验证码宽度 默认120px|
| **height** | 否 | int | 图片验证码高度 默认32px |
| **background** | 否 | String | 背景色颜色值，默认#E8E8E8 |
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"key": "381c1fc567c746d0a4aa33892239cef0", // 图片验证码key
"captcha": "...." // 图片
}
}
```
## **<a name="smsCode"> 短信验证码</a>**
[返回到目录](#menu)
##### URL
[/web/auth/userCtl/smsCode]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
| 参数 | 必选 | 类型 | 说明|
| -------- | -------- | ------------|---------|
| **mobile** | 是 | String | 手机号码|
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
}
```
## **<a name="login"> 登录</a>**
[返回到目录](#menu)
##### URL
[/web/auth/userCtl/login]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
| 参数 | 必选 | 类型 | 说明|
| -------- | -------- | ------------|---------|
| **loginName** | 是 | String | 登录名|
| **password** | 是 | String | 密码 |
| **captchaKey** | 是 | String | 图片验证码key |
| **captchaCode** | 是 | String | 图片验证码填入值 |
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
"data": {
"xggadminsid": "3cb49932-fa02-44f0-90db-9f06fe02e5c7" // 登录key
}
}
```
## **<a name="currentUser"> 当前用户信息查询</a>**
[返回到目录](#menu)
##### URL
[/web/auth/userCtl/currentUser]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
#### 返回结果
```javascript
{
"status": 0,
"msg": "success",
}
```
## **<a name="getMenu"> 获取菜单</a>**
[返回到目录](#menu)
##### URL
[/web/auth/userCtl/getMenu]
#### 参数格式 `JSON`
#### HTTP请求方式 `POST`
#### 返回结果
```javascript
[
{
"name": "首页",
"path": "/",
"submenu": []
},
{
"name": "商户中心",
"path": "/merchants",
"submenu": [
{
"name": "客户管理",
"team": [
{
"name": "商户信息",
"path": "/merchants/businessInformation"
},
...
]
}
]
},
...
]
```
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment