售后模块
- 2021-07-29 13:55:51
- 刘若谷
- 4000
- 最后编辑：刘若谷 于 2021-08-09 17:32:04
- 分享链接
一、获取问题列表
请求地址：GET /api.php/v1/crm/feedbacks
请求头HEADER：
Content-Type: application/json Token: my-token Accept-Language:zh-CN,zh
参数列表：
|
字段 |
必填 | 默认值 | 描述 |
| type | 否 |
personal |
company：全部 p ersonal：指派给我 createdBy：由我创建 |
| sort |
否 |
id_desc |
按照 "_" 字符前面的字段进行排序 desc为降序 asc 为升序 |
| page |
否 |
1 |
页码 |
|
limit |
否 |
20 |
每页行数 |
|
timeFormat |
否 | null |
系统默认返回的日期格式: YYYY-MM-DD HH:ii:ss 传入参数utc后返回的日期格式:
YYYY-MM-DDTHH:ii:ssZ
|
请求示例：
curl --location --request GET 'https://biz.demo.zdoo.com/api.php/v1/crm/feedbacks' \ --header 'Token: my-token' \ --header 'Accept-Language: zh-CN,zh' \ --header 'Content-Type: application/json'
返回结果(200)：
{
"data": {
"status": "success",
"data": {Objects}
}
}
|
字段 |
类型 | 描述 |
|
title |
string | 页面标题 |
|
issues |
array | 问题列表 |
| products |
object
|
产品 列表 |
|
customers |
object | 客户 列表 |
|
contacts |
object
|
联系人 列表 |
|
users |
object
|
用户列表 |
| currentYear | string | 当前搜索年份 |
| currentMonth | string | 当前搜索月份 |
| pager | object | 分页信息 |
| mode | string |
筛选条 件
all:全部订单 |
| orderBy | string |
按照 "_" 字符前面的字段进行排序 desc为降序 asc 为升序 |
二、获取问题详情
请求地址：GET /api.php/v1/crm/feedbacks/:id
请求头HEADER：
Content-Type: application/json Token: my-token Accept-Language:zh-CN,zh
参数列表：
|
字段 |
必填 | 默认值 | 描述 |
|
timeFormat |
否 | null |
系统默认返回的日期格式: YYYY-MM-DD HH:ii:ss 传入参数utc后返回的日期格式:
YYYY-MM-DDTHH:ii:ssZ
|
请求示例：
curl --location --request GET 'https://biz.demo.zdoo.com/api.php/v1/sys/invoices/1' \ --header 'Token: my-token' \ --header 'Accept-Language: zh-CN,zh' \ --header 'Content-Type: application/json'
返回结果(200)：
{
"data": {
"status": "success",
"data": {Objects}
}
|
字段 |
类型 |
描述 |
|
title |
string |
页面标题 |
|
issue |
object |
问题详情 |
|
product |
object |
产品列表 |
|
contact |
object |
关联联系人 |
|
customer |
object |
关联客户 |
|
contract |
object |
关联合同 |
|
actions |
object |
操作记录 |
|
users |
object |
用户列表 |
|
appOperate |
array |
移动端所属动作 |
三、创建售后问题
请求地址：POST /api.php/v1/crm/feedbacks
请求头HEADER：
Content-Type: application/json Token: my-token Accept-Language:zh-CN,zh
请求BODY：
| 字段 | 必填 | 类型 | 描述 |
| product | 是 | int | 所属产品id |
| customer | 是 | int | 所属客户id |
|
contact |
是 | int | 所属联系人id |
|
assignedTo |
否 | int | 要指派给的用户账号 |
| title | 是 | string | 标题 |
|
pri |
否 |
string | 优先级 |
| desc |
是 |
string |
问题描述 |
参数列表：
|
字段 |
必填 | 默认值 | 描述 |
|
timeFormat |
否 | null |
系统默认返回的日期格式: YYYY-MM-DD HH:ii:ss 传入参数utc后返回的日期格式:
YYYY-MM-DDTHH:ii:ssZ
|
请求示例：
curl --location --request POST 'https://biz.demo.zdoo.com/api.php/v1/sys/feedbacks' \
--header 'Token: my-token' \
--header 'Accept-Language: zh-CN,zh' \
--header 'Content-Type: application/json' \
--data-raw '{"product": "1", "customer": "1", "title": "标题"}'
返回结果(200)：
{
"data": {
"result": "success",
"message": "保存成功",
"locate": "/crm/api.php?m=feedback&f=browse&t="
}
}
返回结果(400)：
{
"error": errorMessage
}
四、修改售后问题
请求地址：PUT /api.php/v1/crm/feedbacks/:id
请求头HEADER：
Content-Type: application/json Token: my-token Accept-Language:zh-CN,zh
请求BODY：
| 字段 | 必填 | 类型 | 描述 |
| product | 是 | int | 所属产品id |
| customer | 是 | int | 所属客户id |
| contact | 是 | int | 所属联系人id |
|
assignedTo |
否 | int | 要指派给的用户账号 |
| title | 是 | string | 标题 |
|
pri |
否 |
string | 优先级 |
| desc |
是 |
string |
问题描述 |
参数列表：
参数列表：
|
字段 |
必填 | 默认值 | 描述 |
|
timeFormat |
否 | null |
系统默认返回的日期格式: YYYY-MM-DD HH:ii:ss 传入参数utc后返回的日期格式:
YYYY-MM-DDTHH:ii:ssZ
|
请求示例：
curl --location --request PUT 'https://biz.demo.zdoo.com/api.php/v1/sys/feedbacks/1' \
--header 'Token: my-token' \
--header 'Accept-Language: zh-CN,zh' \
--header 'Content-Type: application/json' \
--data-raw '{"product": "1", "customer": "1", "title": "标题"}'
返回结果(200)：
{
"data": {
"result": "success",
"message": "保存成功",
"locate": "/crm/api.php?m=feedback&f=browse&t="
}
}
返回结果(400)：
{
"error": errorMessage
}
