@iamfox
2018-08-07T01:18:37.000000Z
字数 15376
阅读 2005
车
每个请求的JSON中都要包含自定义头信息,如下:
{
"clientId": "xfkc",
"clientType": "pc_web",
"timestamp": 1531189477255
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
clientId | 客户端id | 字符 | 16 | 是 | 请求来源客户端,可选值有xfkc(幸福快车)、qyt(黔油通)、qsf(黔师傅) |
clientType | 客户端类型 | 字符 | 16 | 是 | 请求来源客户端类型,可选值有pc_web、android、ios、mobile_web、xcx |
timestamp | 当前时间戳 | 数值 | 16 | 是 | 精确到毫秒 |
{
"code":"0",
"message":"请求成功",
"data": ... // 可能是对象或数组或字符
}
所有以/query结尾的get请求接口均为查询类请求,所有查询类请求的{请求JSON}都有如下通用字段:
{
"resultType": "xxx",
"pageNo": 1,
"pageSize": 10,
"limit":100
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
resultType | 查询结果类型 | 字符 | 16 | 是 | 可选值有count(查结果数量)、unique(查单条)、list(查全部列表,默认最多100条),"pagination"(分页查) |
pageNo | 页数 | 数值 | 16 | 否 | 仅当resultType为pagination时可用 |
pageSize | 每页的条数 | 数值 | 16 | 否 | 仅当resultType为pagination时可用 |
limit | 条数 | 数值 | 16 | 否 | 当resultType为limit时,如果100条不满足要求可以修改 |
查询条数返回结构:
{
"code":"0",
"message":"请求成功",
"data": 1000 // count
}
查询单条返回结构:
{
"code":"0",
"message":"请求成功",
"data": {} // unique
}
查询列表返回结构:
{
"code":"0",
"message":"请求成功",
"data": [] // list
}
查询分页返回结构:
{
"code":"0",
"message":"请求成功",
"data": { // pagination
"nextPage": 1, // 下一页页码
"firstPage": true, // 是否是第一页
"startIndex": 0, // 返回列表的起始索引
"totalCount": 4, // 总条数
"pretPage": 1, // 前一页页码
"pageNo": 1, // 当前页码
"pageSize": 10, // 每页条数
"lastPage": true,
"list": [ // 和list查询时data结构一样
],
"totalPage": 1, // 总页数
}
}
api.fengchixinxi.com
请求方法: POST
请求body结构: CreateAdminACmd
示例:
{
"header": {
// 参照基本要求
},
"addPermissionIds": ["permissionId1", "permissionId2"],
"addRoleIds": ["roleId1", "roleId2"],
"enable": true,
"loginName": "xxx",
"mobile": "xxx",
"name": "xxx",
"password": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
addPermissionIds | 要添加的权限id集合 | 数组 | 否 | 赋予该用户角色不包含的额外权限 | |
addRoleIds | 要添加的角色id集合 | 数组 | 否 | 如果不传,会赋予一个“幸福快车运营团队默认角色”的role | |
enable | 是否启用 | 布尔 | 否 | 默认启用 | |
loginName | 登录帐号名 | 字符 | 32 | 是 | |
mobile | 手机号 | 字符 | 16 | 否 | |
name | 真实姓名 | 字符 | 16 | 否 | |
password | 密码 | 字符 | 16 | 是 | 明文 |
返回data结构: AdminVO
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"enable": true,
"id": "1a16e6a6ccdf435fa4df0dcc6087fc3d",
"loginName": "xxx",
"mobile": "1860000000",
"name": "xxx",
"password": "a26610bfe749bee7f38d26fd50a1a33e",
"version": 0
}
}
请求方法: PUT
请求body结构: ModifyAdminACmd
示例:
{
"header": {
// 参照基本要求
},
"addPermissionIds": ["permissionId3"],
"addRoleIds": ["roleId3", "roleId4"],
"enable": true,
"mobile": "xxx",
"password": "xxx",
"removePermissionIds": ["permissionId1", "permissionId2"],
"removeRoleIds": ["roleId1"]
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
addPermissionIds | 要添加的权限id集合 | 数组 | 否 | 赋予该用户角色不包含的额外权限 | |
addRoleIds | 要添加的角色id集合 | 数组 | 否 | 如果不传,会赋予一个“幸福快车运营团队默认角色”的role | |
enable | 是否启用 | 布尔 | 否 | 默认启用 | |
mobile | 手机号 | 字符 | 16 | 否 | |
password | 密码 | 字符 | 16 | 是 | 明文 |
removePermissionIds | 要删除的权限id集合 | 数组 | 否 | ||
removeRoleIds | 要删除的角色id集合 | 数组 | 否 |
返回data结构: AdminVO
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"enable": true,
"id": "1a16e6a6ccdf435fa4df0dcc6087fc3d",
"loginName": "xxx",
"mobile": "1860000000",
"name": "xxx",
"password": "a26610bfe749bee7f38d26fd50a1a33e",
"version": 0
}
}
请求方法: PUT
请求body结构: ChangeAdminEnableACmd
示例:
{
"header": {
// 参照基本要求
},
"adminId": "xxx",
"enable": false
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
adminId | 要修改的管理员id | 字符 | 32 | 是 | |
enable | 是否启用 | 布尔 | 是 |
返回data结构:
示例:
{
"code": "0",
"message": "操作成功"
}
请求方法: DELETE
请求body结构: RemoveAdminACmd
示例:
{
"header": {
// 参照基本要求
},
"adminId": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
adminId | 要删除的管理员id | 字符 | 32 | 是 |
返回data结构:
示例:
{
"code": "0",
"message": "操作成功"
}
请求方法: POST
请求body结构: AdminLoginCheckACmd
示例:
{
"header": {
// 参照基本要求
},
"loginName": "xxx",
"password": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
loginName | 登录帐户名 | 字符 | 32 | 是 | |
password | 密码 | 字符 | 16 | 是 |
返回data结构:
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"clientId": "xfkc",
"clientType": "pc_web",
"createDate": 1531194332000,
"expireDate": 1531280732000,
"id": "16d3f7c938b54645bb48a42fa16d03f9",
"subjectId": "966904b914cb4921a171b5cd952fdd35",
"token": "eyJhbGciOiJIUzUxMiIsInppcCI6IkRFRiJ9.eNqqVkrOyUzNKwmpLEhVslIqSI4vT01S0oGKeqYAxSrSspOBIjn56Zl5fom5IGWJKbmZeQhVBUpWeaU5OTpKqRVApqGpsaGRhYG5sZGOUmZiCUTA0NLE2NioFgAAAP__.5q576SG-D236p5Rxd4ehs0h2dpgzRlnhm7sXGJdY26iPZ6Ey7Evu0CCaEMHOM9eoPWlSET3JXvDcJ4xHNN34_w"
}
}
字段 .................. | 名称 ................... | 类型 ............ | 备注 |
---|---|---|---|
clientId | 登录的客户端id | 字符 | |
clientType | 登录的客户端类型 | 字符 | |
createDate | 登录令牌生成时间 | 时间戳 | |
expireDate | 登录令牌过期时间 | 时间戳 | |
id | 登录令牌id | 字符 | |
subjectId | 登录管理员id | 字符 | |
token | 登录令牌 | 字符 | 要将此令牌在客户端保存,并在每个后续请求的http header中设为loginToken的值 |
请求方法: GET
请求body结构: AdminViewQO
示例:
{
"header": {
// 参照基本要求
},
"adminId": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
adminId | 要删除的管理员id | 字符 | 32 | 是 |
返回data结构:
示例:
{
"code": "0",
"message": "操作成功",
"data":{
...
}
}
请求方法: GET
请求body结构: PageLinkViewQO
示例:
{
"header": {
// 参照基本要求
},
// 查询通用字段略...
"format2Level": true,
"menuKey": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
format2Level | 格式化为二级菜单 | 布尔 | 否 | 默认false,选了以后会返回前两级菜单(root节点不算一级),并且JSON结构中第二级菜单在第一级下面,仅当resultType为list时有效 | |
menuKey | 菜单标识 | 字符 | 16 | 是 | 可选:xfkc-left(幸福快车左边菜单) |
返回data结构:
format2Level为true的结果示例:
{
"code": "0",
"message": "请求成功",
"data": [
{
"root": false, // 是否根节点,菜单是个树形数据
"id": "c9c23062d5a6452eb80064d9d2f6f884",
"uri": "", // 跳转地址
"menuKey": "xfkc-left", // 菜单标识:幸福快车左边菜单
"name": "系统设置", // 显示在菜单上的名字
"treeData": { // 树形数据
"width": 6, // 节点宽度,预排序遍历树算法
"treeId": "xfkc-left", // 树id
"rightValue": 7, // 节点右值,预排序遍历树算法
"parentId": "xfkc-left", // 分节点id
"level": 2, // 层级,含根节点
"leftValue": 2 // 节点左值,预排序遍历树算法
},
"subPageLinks": [ // 子菜单数组
{
"remove": false,
"root": false,
"menuKey": "xfkc-left",
"treeData": {
"rightValue": 6,
"width": 4,
"parentId": "c9c23062d5a6452eb80064d9d2f6f884",
"treeId": "xfkc-left",
"leftValue": 3,
"level": 3
},
"name": "角色列表",
"id": "72fa85d43d7b470fb993ef937f529929",
"uri": ""
}
]
}
]
}
format2Level为false的结果示例:
{
"code": "0",
"message": "请求成功",
"data": [ // 未做二级整理,全部列为一个数组的菜单
{
"id": "72fa85d43d7b470fb993ef937f529929",
"remove": false,
"name": "角色列表",
"uri": "",
"menuKey": "xfkc-left",
"treeData": {
"width": 4,
"level": 3,
"leftValue": 3,
"treeId": "xfkc-left",
"parentId": "c9c23062d5a6452eb80064d9d2f6f884",
"rightValue": 6
},
"root": false
},
{
"menuKey": "xfkc-left",
"treeData": {
"parentId": "72fa85d43d7b470fb993ef937f529929",
"level": 4,
"width": 2,
"rightValue": 5,
"treeId": "xfkc-left",
"leftValue": 4
},
"remove": false,
"name": "角色添加",
"uri": "",
"id": "8dae805638f34c55ae7986db04b29db5",
"root": false
},
{
"menuKey": "xfkc-left",
"id": "c9c23062d5a6452eb80064d9d2f6f884",
"uri": "",
"name": "系统设置",
"root": false,
"treeData": {
"rightValue": 7,
"parentId": "xfkc-left",
"leftValue": 2,
"width": 6,
"level": 2,
"treeId": "xfkc-left"
},
"remove": false
},
{
"treeData": {
"leftValue": 1,
"width": 8,
"level": 1,
"rightValue": 8,
"treeId": "xfkc-left"
},
"name": "根节点",
"remove": false,
"menuKey": "xfkc-left",
"id": "xfkc-left",
"root": true
}
]
}
请求方法: GET
请求body结构: RoleViewQO
示例:
{
"header": {
// 参照基本要求
},
// 查询通用字段略...
"format2Level": true,
"menuKey": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
fetchPermissions | 查询加载角色拥有的所有权限 | 布尔 | 否 | 默认false,仅当resultType为unique时有效 | |
fetchPermissionClassification | 查询加载的权限按上下级结构返回 | 布尔 | 否 | 默认为false,仅当resultType为unique时有效 |
返回data结构:
format2Level为true的结果示例:
{
"code": "0",
"message": "请求成功",
"data": [
{
"root": false, // 是否根节点,菜单是个树形数据
"id": "c9c23062d5a6452eb80064d9d2f6f884",
"uri": "", // 跳转地址
"menuKey": "xfkc-left", // 菜单标识:幸福快车左边菜单
"name": "系统设置", // 显示在菜单上的名字
"treeData": { // 树形数据
"width": 6, // 节点宽度,预排序遍历树算法
"treeId": "xfkc-left", // 树id
"rightValue": 7, // 节点右值,预排序遍历树算法
"parentId": "xfkc-left", // 分节点id
"level": 2, // 层级,含根节点
"leftValue": 2 // 节点左值,预排序遍历树算法
},
"subPageLinks": [ // 子菜单数组
{
"remove": false,
"root": false,
"menuKey": "xfkc-left",
"treeData": {
"rightValue": 6,
"width": 4,
"parentId": "c9c23062d5a6452eb80064d9d2f6f884",
"treeId": "xfkc-left",
"leftValue": 3,
"level": 3
},
"name": "角色列表",
"id": "72fa85d43d7b470fb993ef937f529929",
"uri": ""
}
]
}
]
}
format2Level为false的结果示例:
{
"code": "0",
"message": "请求成功",
"data": [ // 未做二级整理,全部列为一个数组的菜单
{
"id": "72fa85d43d7b470fb993ef937f529929",
"remove": false,
"name": "角色列表",
"uri": "",
"menuKey": "xfkc-left",
"treeData": {
"width": 4,
"level": 3,
"leftValue": 3,
"treeId": "xfkc-left",
"parentId": "c9c23062d5a6452eb80064d9d2f6f884",
"rightValue": 6
},
"root": false
},
{
"menuKey": "xfkc-left",
"treeData": {
"parentId": "72fa85d43d7b470fb993ef937f529929",
"level": 4,
"width": 2,
"rightValue": 5,
"treeId": "xfkc-left",
"leftValue": 4
},
"remove": false,
"name": "角色添加",
"uri": "",
"id": "8dae805638f34c55ae7986db04b29db5",
"root": false
},
{
"menuKey": "xfkc-left",
"id": "c9c23062d5a6452eb80064d9d2f6f884",
"uri": "",
"name": "系统设置",
"root": false,
"treeData": {
"rightValue": 7,
"parentId": "xfkc-left",
"leftValue": 2,
"width": 6,
"level": 2,
"treeId": "xfkc-left"
},
"remove": false
},
{
"treeData": {
"leftValue": 1,
"width": 8,
"level": 1,
"rightValue": 8,
"treeId": "xfkc-left"
},
"name": "根节点",
"remove": false,
"menuKey": "xfkc-left",
"id": "xfkc-left",
"root": true
}
]
}
api.fengchixinxi.com
请求方法: POST
请求body结构: CreateArticleChannelSCmd
示例:
{
"header": {
// 参照基本要求
},
"description": "体育频道",
"name": "体育",
"show": true,
"sort":0
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
description | 频道描述 | 字符 | 256 | 否 | |
name | 名称 | 字符 | 32 | 否 | |
show | 是否显示 | 布尔 | 否 | 默认false | |
sort | 排序 | 数值 | 16 | 否 | 整数,数字越大查询时越靠前,默认0 |
返回data结构: ArticleChannelVO
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"name": "体育",
"show": true,
"description": "体育频道",
"id": "2ad23512910346c387b52f9b96dbf753",
"sort": 0
}
}
请求方法: PUT
请求body结构: ModifyArticleChannelSCmd
示例:
{
"header": {
// 参照基本要求
},
"articleChannelId":"xxx",
"description": "体育频道",
"name": "体育",
"show": true,
"sort":0
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
articleChannelId | 主键 | 字符 | 32 | 是 | 要修改的频道id |
description | 频道描述 | 字符 | 256 | 否 | |
name | 名称 | 字符 | 32 | 否 | |
show | 是否显示 | 布尔 | 否 | 默认false | |
sort | 排序 | 数值 | 16 | 否 | 整数,数字越大查询时越靠前,默认0 |
返回data结构: ArticleChannelVO
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"name": "体育",
"show": true,
"description": "体育频道",
"id": "2ad23512910346c387b52f9b96dbf753",
"sort": 0
}
}
请求方法: PUT
请求body结构: ChangeArticleChannelShowSCmd
示例:
{
"header": {
// 参照基本要求
},
"articleChannelId":"xxx",
"show": true
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
articleChannelId | 主键 | 字符 | 32 | 是 | 要修改的频道id |
show | 是否显示 | 布尔 | 否 | 默认false |
返回data结构: null
示例:
{
"code": "0",
"message": "操作成功"
}
请求方法: DELETE
请求body结构: DeleteArticleChannelSCmd
物理删除,属于该频道的资讯将变成无频道资讯
示例:
{
"header": {
// 参照基本要求
},
"articleChannelId":"xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
articleChannelId | 主键 | 字符 | 32 | 是 | 要删除的频道id |
返回data结构: null
示例:
{
"code": "0",
"message": "操作成功"
}
请求方法: POST
请求body结构: CreateArticleSCmd
示例:
{
"header": {
// 参照基本要求
},
"articleChannelId": "2ad23512910346c387b52f9b96dbf753",
"content": "xxxxxxxxxxxxxxxxxxxxxxx",
"sort": 0,
"subhead": "这你也信?",
"title": "中国队勇夺世界杯",
"titleImageId": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
articleChannelId | 所属频道id | 字符 | 32 | 否 | |
content | 正文 | 字符 | 否 | 富文本 | |
subhead | 副标题 | 字符 | 256 | 否 | |
title | 标题 | 字符 | 128 | 否 | |
sort | 排序 | 数值 | 16 | 否 | 整数,数字越大查询时越靠前,默认0 |
titleImageId | 标题图片id | 字符 | 32 | 是 | 图片上传接口返回的图片id |
返回data结构: ArticleVO
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"channel": {
"id": "c496ccd010754edbb48d6c638eae5828"
},
"show": false,
"subhead": "这你也信?",
"check": "wait",
"id": "71e997971e41487aad67640c74794fd4",
"sort": 0,
"title": "中国队勇夺世界杯",
"content": "xxxxxxxxxxxxxxxxxxxxxxx",
"createDate": 1533408448594
}
}
字段 .................. | 名称 ................... | 类型 ............ | 备注 |
---|---|---|---|
channel.id | 所属频道id | 字符 | |
id | 资讯id | 字符 | |
content | 正文 | 字符 | 富文本 |
subhead | 副标题 | 字符 | |
title | 标题 | 字符 | |
sort | 排序 | 数值 | 整数,数字越大查询时越靠前,默认0 |
show | 是否显示 | 布尔 | 用于控制前台显示 |
check | 审核状态 | 字符 | wait待审核,approve通过,disapprove未通过 |
createDate | 创建时间 | 数值 | 时间戳,精确到毫秒 |
请求方法: PUT
请求body结构: ModifyArticleSCmd
示例:
{
"header": {
// 参照基本要求
},
"articleId":"xxx",
"articleChannelId": "2ad23512910346c387b52f9b96dbf753",
"content": "xxxxxxxxxxxxxxxxxxxxxxx",
"sort": 0,
"subhead": "这你也信?",
"title": "中国队勇夺世界杯",
"titleImageId": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
articleId | 资讯id | 字符 | 32 | 否 | 要修改的资讯id |
articleChannelId | 所属频道id | 字符 | 32 | 否 | |
content | 正文 | 字符 | 否 | 富文本 | |
subhead | 副标题 | 字符 | 256 | 否 | |
title | 标题 | 字符 | 128 | 否 | |
sort | 排序 | 数值 | 16 | 否 | 整数,数字越大查询时越靠前,默认0 |
titleImageId | 标题图片id | 字符 | 32 | 是 | 图片上传接口返回的图片id |
返回data结构: ArticleVO
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"channel": {
"id": "c496ccd010754edbb48d6c638eae5828"
},
"show": false,
"subhead": "这你也信?",
"check": "wait",
"id": "71e997971e41487aad67640c74794fd4",
"sort": 0,
"title": "中国队勇夺世界杯",
"content": "xxxxxxxxxxxxxxxxxxxxxxx",
"createDate": 1533408448594
}
}
字段 .................. | 名称 ................... | 类型 ............ | 备注 |
---|---|---|---|
channel.id | 所属频道id | 字符 | |
id | 资讯id | 字符 | |
content | 正文 | 字符 | 富文本 |
subhead | 副标题 | 字符 | |
title | 标题 | 字符 | |
sort | 排序 | 数值 | 整数,数字越大查询时越靠前,默认0 |
show | 是否显示 | 布尔 | 用于控制前台显示 |
check | 审核状态 | 字符 | wait待审核,approve通过,disapprove未通过 |
createDate | 创建时间 | 数值 | 时间戳,精确到毫秒 |
请求方法: PUT
请求body结构: CheckArticleSCmd
物理删除,属于该频道的资讯将变成无频道资讯
示例:
{
"header": {
// 参照基本要求
},
"articleId":"xxx",
"approve":true
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
articleId | 主键 | 字符 | 32 | 是 | 要审核的频道id |
approve | 是否通过审核 | 布尔 | 是 |
返回data结构: null
示例:
{
"code": "0",
"message": "操作成功"
}
请求方法: GET
请求body结构: ArticleViewQO
示例:
{
"header": {
// 参照基本要求
},
"adminId": "xxx"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
adminId | 要删除的管理员id | 字符 | 32 | 是 |
返回data结构:
示例:
{
"code": "0",
"message": "操作成功",
"data":{
...
}
}
api.fengchixinxi.com
请求方法: POST
请求body结构: CreateMotorcadeSCmd
示例:
{
"header": {
// 参照基本要求
},
"albumImageIds": ["2", "3"],
"captainId": "xxx",
"flagImageId": "4",
"intro": "oooooooooooo",
"name": "法拉利车队",
"sort": 0
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
albumImageIds | 相册图片id | 数组 | 否 | 上传图片接口返回的图片id集合 | |
name | 名称 | 字符 | 32 | 否 | |
captainId | 队长id | 字符 | 否 | 用户查询接口返回的id | |
flagImageId | 队标图片id | 字符 | 否 | 上传图片接口返回的id | |
intro | 介绍 | 字符 | 否 | 富文本 | |
sort | 排序 | 数值 | 16 | 否 | 整数,数字越大查询时越靠前,默认0 |
返回data结构: MotorcadeVO
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"captainId": "xxx",
"intro": "oooooooooooo",
"name": "法拉利车队",
"show": false, // 显示
"onTop": false, // 置顶
"flagImageId": "4",
"check": "wait", // wait待审核,approve已通过,disapprove未通过
"id": "de9dda877ae14add8ca4e252a729fe9a",
"sort": 0, // 排序,大的在前
"createDate": 1533575122805
}
}
请求方法: PUT
请求body结构: ModifyMotorcadeSCmd
示例:
{
"header": {
// 参照基本要求
},
"addAlbumImageIds": ["3","4"], // 新增的相册图片
"removeAlbumImageIds": ["2"], // 删掉的相册图片
"captainId": "xxx",
"flagImageId": "3",
"intro": "oooooooooooo",
"motorcadeId": "de9dda877ae14add8ca4e252a729fe9a",
"name": "法拉利车队",
"sort": 1
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
addAlbumImageIds | 新增相册图片id | 数组 | 否 | 新增的相册图片id集合 | |
removeAlbumImageIds | 删除相册图片id | 数组 | 否 | 删掉的相册图片id集合 | |
name | 名称 | 字符 | 32 | 否 | |
captainId | 队长id | 字符 | 否 | 用户查询接口返回的id | |
flagImageId | 队标图片id | 字符 | 否 | 上传图片接口返回的id | |
intro | 介绍 | 字符 | 否 | 富文本 | |
sort | 排序 | 数值 | 16 | 否 | 整数,数字越大查询时越靠前,默认0 |
返回data结构: MotorcadeVO
示例:
{
"code": "0",
"message": "操作成功",
"data": {
"captainId": "xxx",
"intro": "oooooooooooo",
"name": "法拉利车队",
"show": false, // 显示
"onTop": false, // 置顶
"flagImageId": "4",
"check": "wait", // wait待审核,approve已通过,disapprove未通过
"id": "de9dda877ae14add8ca4e252a729fe9a",
"sort": 0, // 排序,大的在前
"createDate": 1533575122805
}
}
请求方法: PUT
请求body结构: CheckMotorcadeSCmd
示例:
{
"header": {
// 参照基本要求
},
"approve": true,
"motorcadeId": "de9dda877ae14add8ca4e252a729fe9a"
}
字段 .................. | 名称 ................... | 类型 ............ | 长度 ...... | 是否必填 ........ | 备注 |
---|---|---|---|---|---|
motorcadeId | 车队id | 字符 | 32 | 是 | |
approve | 队长id | 布尔 | 否 | 用户查询接口返回的id |
返回data结构: MotorcadeVO
示例:
{
"code": "0",
"message": "操作成功"
}