YesDev
HTTP/HTTPS
请求协议
YesDev / WebAPI / 数据洞察
数据洞察
接口地址：https://www.yesdev.cn/api/platform.php?s=Platform.DataInsight_DataInsight.DataInsight
接口描述： 数据洞察
接口参数
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|---|---|---|---|---|---|
| access_token | 字符串 | 可选 | 访问令牌，仅当开启签名验证时需要传递，生成令牌可使用App.Auth.ApplyToken接口 | ||
| app_key | 字符串 | 可选 | app_key，团队代码 | ||
| sign | 字符串 | 可选 | - | 动态签名，签名算法请联系我们技术客服获取 | |
| start_time | 字符串 | 可选 | - | 开始时间,格式2021-09-10 | |
| end_time | 字符串 | 可选 | - | 结束时间，格式2021-09-10 |
返回字段
| 返回结果 | 类型 | 说明 |
|---|---|---|
| ret | 整型 | 状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务器错误 |
| data | 对象或混合类型 | 业务数据，由各自接口指定，通常为对象 |
| msg | 字符串 | 提示信息，失败时的错误提示 |
在线测试
| 参数 | 是否必须 | 值 |
|---|---|---|
| service | 必须 | |
| access_token | 可选 | |
| app_key | 可选 | |
| sign | 可选 | |
| start_time | 可选 | |
| end_time | 可选 |
客户端请求示例
{
"ret": 200,
"data": {
"data_insight": { //数据洞察
"on_line_time": "99", //在线多少天
"cont_total": { //团队总数据
"project_total_nums": 72, //项目总数据
"need_total_nums": 309, //需求总数据
"problem_total_nums": 140, //问题总数据
"task_total_nums": 414 //任务总数据
},
"lately_form_date": { //最近完成
"project_from_data": { //项目最近完成数据
"problem_analysis_echarts_data": { //项目最近完成表格数据
"title": { //线
"title": [ //英文线
"project_status_0",
"project_status_1",
"project_status_2",
"project_status_3"
],
"title_name": [ //对应英文的中文线
"规划中",
"进行中",
"已完成",
"挂起"
]
},
"time_section_arr": [ //时间区域
"2021-09-28",
"2021-09-29"
],
"data": {
"project_status_0": [ //对应线是数据
0,
0
],
"project_status_1": [
1,
0
],
"project_status_2": [
1,
0
],
"project_status_3": [
0,
0
]
}
}
},
"need_from_data": { //参考上面项目
"problem_analysis_echarts_data": {
"title": {
"title": [
"need_status_0",
"need_status_1",
"need_status_2",
"need_status_3",
"need_status_4",
"need_status_5",
"need_status_6",
"need_status_7"
],
"title_name": [
"需求中",
"设计中",
"产品中",
"研发中",
"测试中",
"已上线",
"已完成",
"挂起"
]
},
"time_section_arr": [
"2021-09-28",
"2021-09-29"
],
"data": {
"need_status_0": [
1,
0
],
"need_status_1": [
0,
0
],
"need_status_2": [
0,
0
],
"need_status_3": [
2,
0
],
"need_status_4": [
0,
0
],
"need_status_5": [
0,
0
],
"need_status_6": [
0,
0
],
"need_status_7": [
0,
0
]
}
}
},
"problem_from_data": {
"problem_analysis_echarts_data": {
"title": {
"title": [
"problem_status_1",
"problem_status_2",
"problem_status_3",
"problem_status_4",
"problem_status_5",
"problem_status_6",
"problem_status_7"
],
"title_name": [
"待解决",
"进行中",
"重开",
"已解决",
"暂缓",
"误报",
"已关闭"
]
},
"time_section_arr": [
"2021-09-28",
"2021-09-29"
],
"data": {
"problem_status_1": [
0,
0
],
"problem_status_2": [
0,
0
],
"problem_status_3": [
0,
0
],
"problem_status_4": [
0,
0
],
"problem_status_5": [
0,
0
],
"problem_status_6": [
0,
0
],
"problem_status_7": [
0,
0
]
}
}
},
"task_from_data": {
"problem_analysis_echarts_data": {
"title": {
"title": [
"task_status_0",
"task_status_1",
"task_status_2"
],
"title_name": [
"TODO",
"DOING",
"DONE"
]
},
"time_section_arr": [
"2021-09-28",
"2021-09-29"
],
"data": {
"task_status_0": [
0,
0
],
"task_status_1": [
0,
0
],
"task_status_2": [
0,
0
]
}
}
}
},
"active_data": { //团队活跃书
"active_list_data": [
{
"id": 20003,
"app_key": "gc",
"stat_day": "2021-09-28", //日期
"total_project": 70, //项目数量
"total_task_time": "1629.10", //任务总工时
"total_user": 49,
"total_requirement": 307,
"total_problem": 140, //问题数量
"add_time": "2021-09-29 00:05:10",
"total_app": 1,
"total_task": 401, //任务数量
"app_key_visit": 1,
"user_visit": 2, //uv
"api_request_times": 3820,
"total_task_todo": 303, //todo 任务数
"total_task_doing": 26, //doing任务数
"total_task_done": 71, //done任务数
"total_task_time_todo": "871.10",
"total_task_time_doing": "81.00",
"total_task_time_done": "671.00",
"total_staff": 61 //员工数量
},
{
"id": 20190,
"app_key": "gc",
"stat_day": "2021-09-29",
"total_project": 72,
"total_task_time": "1646.10",
"total_user": 49,
"total_requirement": 309,
"total_problem": 140,
"add_time": "2021-09-30 00:05:10",
"total_app": 1,
"total_task": 405,
"app_key_visit": 1,
"user_visit": 4,
"api_request_times": 6150,
"total_task_todo": 304,
"total_task_doing": 27,
"total_task_done": 73,
"total_task_time_todo": "875.10",
"total_task_time_doing": "81.00",
"total_task_time_done": "684.00",
"total_staff": 61
}
],
"active_from_data": { //参考上面的项目
"title": {
"title": [
"total_task_time_todo",
"total_task_time_doing",
"total_task_time_done"
],
"title_name": [
"todo",
"doing",
"done"
]
},
"time_section_arr": [
"2021-09-28",
"2021-09-29"
],
"data": {
"total_task_time_todo": [
"871.10",
"875.10"
],
"total_task_time_doing": [
"81.00",
"81.00"
],
"total_task_time_done": [
"671.00",
"684.00"
]
}
}
}
}
},
"msg": ""
}
错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400，客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406，access_token令牌校验不通过 |
| 407 | ret=407，app_key权限不足，或未知应用 |
| 408 | ret=408，当前用户禁止使用，或用户未登录 |
| 410 | 权限不足 |
| 500 | 表示服务端内部错误 |
本文档生成时间：2024-04-27 17:59:28 联系我们开通接入OpenAPI