问题 API
所有问题 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/ |
问题详情 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/ |
创建问题 POST /portal/[PORTALID]/projects/[PROJECTID]/bugs/ |
更新问题 POST /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/ |
删除问题 DELETE /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/ |
添加评论 POST /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/ |
获取评论 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/ |
删除评论 DELETE /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/[COMMENTID] |
获取问题计时器 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/timer |
获取问题自定义视图 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/customviews/ |
获取问题附件 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/attachments/ |
获取问题解决方案 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/resolution/ |
添加问题关注者 POST /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/ |
获取问题关注者 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/ |
删除问题关注者 DELETE /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/ |
问题默认字段 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/defaultfields/ |
问题自定义字段 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/customfields/ |
问题活动 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/activities/ |
获取重命名值 GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/renamedfields/ |
所有问题
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/
获取给定项目中的所有问题。
请求参数
索引 | 整数型 | 起始索引 |
范围 | 整数型 | 记录(问题)数 |
状态类型 | 字符串 | 可接受值:打开/关闭 |
cview_id | 长整型 | 自定义视图 ID |
sort_column | 字符串 | 可接受值:created_time/last_modified_time |
sort_order | 字符串 | 可接受值:升序/降序 |
状态 | JSON 数组 | 状态 ID,作为逗号分隔的数组 |
严重性 | JSON 数组 | 严重性 ID,作为逗号分隔的数组 |
分类 | JSON 数组 | 分类 ID,作为逗号分隔的数组 |
模块 | JSON 数组 | 模块 ID,作为逗号分隔的数组 |
里程碑 | JSON 数组 | 里程碑 ID,作为逗号分隔的数组 |
标记 | 字符串 | 可接受值:内部/外部 |
受托人 | JSON 数组 | 受托人 ID,作为逗号分隔的数组 |
升级 | JSON 数组 | 升级 ID,作为逗号分隔的数组 |
报告者 | JSON 数组 | 报告者 ID,作为逗号分隔的数组 |
受影响 | JSON 数组 | 受影响里程碑 ID,作为逗号分隔的数组 |
样本响应
Status: 200 Success Content Type: application/json;charset=utf-8
{ "bugs": [{ "module": { "id": 170876000000494013, "name": "ERP Phase I" }, "created_time_long": 1400012857000, "customfields": [{ "label_name": "SNo", "value": "81", "column_name": "LONG1" }, { "label_name": "Sub Module", "value": "Finance", "column_name": "CHAR3" }, { "label_name": "Browser", "value": "Chrome", "column_name": "CHAR2" }, { "label_name": "Product", "value": "Code Manager", "column_name": "CHAR1" }], "status": { "id": 170876000000065048, "type": "InProgress" }, "reproducible": { "id": 170876000000133005, "type": "Always" }, "link": { "self": { "url": "https://projects.zoho.com/restapi/portal/2063927/projects/ 170876000000147021/bugs/170876000001834047/" }, "timesheet": { "url": "https://projects.zoho.com/restapi/portal/2063927/projects/ 170876000000147021/bugs/170876000001834047/logs/" } }, "severity": { "id": 170876000000065005, "type": "Major" }, "reported_person": "Patricia Boyle", "id": 170876000001834047, "title": "Tilt causes crash", "flag": "Internal", "assignee_name": "Not Assigned", "reporter_id": "2060758", "classification": { "id": 170876000000133041, "type": "Feature(New)" }, "created_time_format": "05-13-2014 05:57 PM", "closed": false, "created_time": "05-13-2014", "key": 541 }] }
问题详情
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/
获取问题的详情。
样本响应
Status: 200 Success Content Type: application/json;charset=utf-8
{ "bugs": [{ "module": { "id": 170876000000494013, "name": "ERP Phase I" }, "created_time_long": 1400012857000, "customfields": [{ "label_name": "SNo", "value": "81", "column_name": "LONG1" }, { "label_name": "Sub Module", "value": "Finance", "column_name": "CHAR3" }, { "label_name": "Browser", "value": "Chrome", "column_name": "CHAR2" }, { "label_name": "Product", "value": "Code Manager", "column_name": "CHAR1" }], "status": { "id": 170876000000065048, "type": "InProgress" }, "reproducible": { "id": 170876000000133005, "type": "Always" }, "link": { "self": { "url": "https://projects.zoho.com/restapi/portal/2063927/ projects/170876000000147021/bugs/170876000001834047/" }, "timesheet": { "url": "https://projects.zoho.com/restapi/portal/2063927/ projects/170876000000147021/bugs/170876000001834047/logs/" } }, "severity": { "id": 170876000000065005, "type": "Major" }, "reported_person": "Patricia Boyle", "id": 170876000001834047, "title": "Tilt causes crash", "flag": "Internal", "assignee_name": "Not Assigned", "reporter_id": "2060758", "classification": { "id": 170876000000133041, "type": "Feature(New)" }, "created_time_format": "05-13-2014 05:57 PM", "closed": false, "created_time": "05-13-2014", "key": 541 }] }
创建问题
POST /portal/[PORTALID]/projects/[PROJECTID]/bugs/
创建问题。
请求参数
标题* | 字符串 | 问题的名称。 |
描述 | 字符串 | 问题的描述。 |
受托人 | 长整型 | 问题的受托人。 |
标记 | 字符串 | 问题标记必须为内部或外部。 |
classification_id | 长整型 | 项目的分类 ID。 |
milestone_id | 长整型 | 项目的里程碑 ID。 |
due_date | 字符串 [MM-DD-YYYY] | 问题的到期日期。 |
module_id | 长整型 | 项目的模块 ID。 |
severity_id | 长整型 | 项目的严重性 ID。 |
reproducible_id | 长整型 | 项目的可重现 ID。 |
affectedmile_id | 长整型 | 项目的里程碑 ID。 |
bug_followers | 长整型 | 用户的关注者 ID。 |
uploaddoc | 文件 | 上传文件的最大大小为 128 MB。 |
自定义字段 | ||
CHAR1 - CHAR12 | 字符串 | 自定义字段的任何文本类型,带字符串或选择列表值。 |
LONG1 - LONG4 | 长整型 | 自定义字段的数字类型。 |
DATE1 - DATE4 | 字符串 [MM -DD-YYYY] | 日期格式的问题自定义字段。 |
样本响应
Status: 201 Created Content Type: application/json;charset=utf-8
{ "bugs": [{ "id": 170876000001851001, "key": "543", "project": { "id": 170876000000147021 }, "flag": "Internal", "title": "UI issue in Status text box", "reporter_id": "2060758", "reported_person": "Patricia Boyle", "created_time": "05-27-2014 08:38 AM", "created_time_long": 1401188920000, "assignee_name": "Not Assigned", "classification": { "id": 170876000000133041, "type": "Feature(New)" }, "severity": { "id": 170876000000065005, "type": "Major" }, "status": { "id": 170876000001077429, "type": "known limitation" }, "closed": false, "reproducible": { "id": 170876000000133005, "type": "Always" }, "module": { "id": 170876000000494013, "name": "ERP Phase I" }, "link": { "self": { "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/ 170876000000147021/bugs/170876000001851001/" }, "timesheet": { "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/ 170876000000147021/bugs/170876000001851001/logs/" } } }] }
更新问题
POST /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/
更新问题。
请求参数
标题 | 字符串 | 问题的名称。 |
描述 | 字符串 | 问题的描述。 |
受托人 | 长整型 | 问题的受托人。 |
标记 | 字符串 | 问题标记必须为内部或外部。 |
classification_id | 长整型 | 项目的分类 ID。 |
milestone_id | 长整型 | 项目的里程碑 ID。 |
due_date | 字符串 [MM-DD-YYYY] | 问题的到期日期。 |
module_id | 长整型 | 项目的模块 ID。 |
severity_id | 长整型 | 项目的严重性 ID。 |
reproducible_id | 长整型 | 项目的可重现 ID。 |
status_id | 长整型 | 项目的状态 ID。 |
解决方案 | 字符串 | 解决方案文本。 |
affectedmile_id | 长整型 | 项目的里程碑 ID。 |
uploaddoc | 文件 | 上传文件的最大大小为 128 MB。 |
自定义字段 | ||
CHAR1 - CHAR12 | 字符串 | 自定义字段的任何文本类型,带字符串或选择列表值。 |
LONG1 - LONG4 | 长整型 | 自定义字段的数字类型。 |
DATE1 - DATE4 | 字符串 [MM -DD-YYYY] | 日期格式的问题自定义字段。 |
样本响应
Status: 200 Success Content Type: application/json;charset=utf-8
{ "bugs": [{ "id": 170876000001851001, "key": "543", "project": { "id": 170876000000147021 }, "flag": "Internal", "title": "UI issue in Status options", "reporter_id": "2060758", "reported_person": "Patricia Boyle", "created_time": "05-27-2014 08:38 AM", "created_time_long": 1401188920000, "assignee_name": "Not Assigned", "classification": { "id": 170876000000133041, "type": "Feature(New)" }, "severity": { "id": 170876000000065005, "type": "Major" }, "status": { "id": 170876000001077429, "type": "known limitation" }, "closed": false, "reproducible": { "id": 170876000000133005, "type": "Always" }, "module": { "id": 170876000000494013, "name": "ERP Phase I" }, "link": { "self": { "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/ 170876000000147021/bugs/170876000001851001/" }, "timesheet": { "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/ 170876000000147021/bugs/170876000001851001/logs/" } } }] } }
删除问题
DELETE /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/
删除问题。
样本响应
Status: 200 Success Content Type: application/json;charset=utf-8
{ "response": "Bug Deleted Successfully" }
添加评论
POST /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/
对问题添加评论。
请求参数
内容 | 字符串 | 评论 |
Status: 200 Success Content Type: application/json;charset=utf-8
{ "comments": [{ "comment_id": "170876000004079025", "created_time_long": 1480404045459, "added_by": "2060758", "added_person": "Patricia Boyle", "created_time_format": "11-29-2016 12:50:45 PM", "created_time": "11-29-2016", "comment": "Attach latest screenshot" }] }
获取评论
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/
提取问题的评论。
请求参数
索引 | 整数型 | 起始索引 |
范围 | 整数型 | 问题的范围(最大限制 100) |
Status: 200 Success Content Type: application/json;charset=utf-8
{ "comments": [{ "updated_time_format": "08-21-2015 02:46:37 PM", "comment_id": "170876000002584007", "created_time_long": 1440078009132, "added_by": "2060758", "updated_time_long": 1440148597805, "added_person": "Patricia Boyle", "updated_by": "2060758", "created_time_format": "08-20-2015 07:10:09 PM", "updated_person": "Patricia Boyle", "created_time": "08-20-2015", "comment": "Attach screenshot for reference.", "updated_time": "08-21-2015" }] }
刪除评论
DELETE /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/[COMMENTID]
删除问题的评论。
Status: 200 Success Content Type: application/json;charset=utf-8
{ "response": "Bug Comment Deleted Successfully" }
获取问题计时器
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/timer
获取问题的计时器详情。
获取问题自定义视图
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/customviews/
获取问题的自定义视图。
Status: 200 Success Content Type: application/json;charset=utf-8
{ "cview_details": [{ "is_fav": "false", "cview_id": "170876000002850082", "cview_name": "My Bug" }, { "is_fav": "false", "cview_id": "170876000002784151", "cview_name": "Scrum review" }, { "is_fav": "false", "cview_id": "170876000002218264", "cview_name": "Modified Today" }, { "is_fav": "true", "cview_id": "170876000002043129", "cview_name": "ERP Phase" }, { "is_fav": "true", "cview_id": "170876000002043117", "cview_name": "Projects 5.0" }] }
获取问题附件
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/attachments/
获取问题的附件详情。
Status: 200 Success Content Type: application/json;charset=utf-8
{ "attachment_details": [{ "attached_time": "11-29-2016", "file_size": "323412", "attached_time_format": "11-29-2016 12:58:36 PM", "author_name": "Patricia Boyle", "author_id": "2060758", "file_uri": "https://projects.zoho.com/portal/zillum/openAttachment/download?file=74e813222afaec070dcb08aee251c02203ed7adc067c731c82d9f6824ba2dea93e22c47ad4d2f3e01fce745875770445", "attached_time_long": 1480404516000, "file_name": "screenshot_1480433316000.png", "file_type": "image/png" }] }
获取问题解决方案
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/resolution/
获取问题的解决方案。
Status: 200 Success Content Type: application/json;charset=utf-8
{ "resolution_details": [{ "resolved_time": "11-29-2016", "resolved_time_format": "11-29-2016 01:02:06 PM", "issue_id": "170876000003764009", "resolved_time_long": 1480404726027, "resolver": "Patricia Boyle", "resolver_id": "2060758", "resolution": "It will taken by content team" }] }
添加问题关注者
POST /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/
对问题添加关注者。
请求参数
bug_followers | 长整型 | 用户 Id |
Status: 200 Success Content Type: application/json;charset=utf-8
{ "folower_details": [{ "follower_id": "50929640", "issue_id": "170876000003702035", "follower_name": "Patricia Boyle" }] }
获取问题关注者
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/
获取问题的关注者列表。
Status: 200 Success Content Type: application/json;charset=utf-8
{ "issue_follower": [{ "follower_id": "50929640", "issue_id": "170876000003702035", "follower_name": "Patricia Boyle" }] }
删除问题关注者
DELETE /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/
删除问题的关注者。
Status: 200 Success Content Type: application/json;charset=utf-8
{ "response": "Bug Followers Deleted Successfully" }
问题默认字段
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/defaultfields/
获取给定项目中的所有默认字段。
样本响应
Status: 200 Success Content Type: application/json;charset=utf-8
{ "defaultfields": { "severity_details": [{ "severity_id": "170876000000559001", "severity_name": "Show stopper" }, { "severity_id": "170876000000065003", "severity_name": "Critical" }, { "severity_id": "170876000000065005", "severity_name": "Major" }, { "severity_id": "170876000000065007", "severity_name": "Minor" }, { "severity_id": "170876000000553001", "severity_name": "Show Stopper" }], "status_deatils": [{ "isdefault": false, "status_name": "Open", "status_id": "170876000000065045", "closed": false }, { "isdefault": false, "status_name": "Assigned", "status_id": "170876000000553005", "closed": false }, { "isdefault": false, "status_name": "To test", "status_id": "170876000000587011", "closed": false }, { "isdefault": false, "status_name": "To be fixed", "status_id": "170876000001834225", "closed": false }, { "isdefault": false, "status_name": "InProgress", "status_id": "170876000000065048", "closed": false }, { "isdefault": false, "status_name": "Reopen", "status_id": "170876000000065057", "closed": false }, { "isdefault": false, "status_name": "Closed", "status_id": "170876000000065054", "closed": true }, { "isdefault": false, "status_name": "To be analyzed", "status_id": "170876000000584017", "closed": false }, { "isdefault": false, "status_name": "Not an issue", "status_id": "170876000001071093", "closed": true }, { "isdefault": false, "status_name": "Failed Issues", "status_id": "170876000001077005", "closed": false }, { "isdefault": true, "status_name": "known limitation", "status_id": "170876000001077429", "closed": true }], "module_details": [{ "module_id": "170876000000170057", "module_name": "ERP Phase III" }, { "module_id": "170876000000494013", "module_name": "ERP Phase I" }, { "module_id": "170876000001023026", "module_name": "Post Release - Project 4.0 Feedback" }, { "module_id": "170876000001829185", "module_name": "SAP Phase" }], "priority_details": [{ "priority_id": "170876000000133005", "priority_name": "Always" }, { "priority_id": "170876000000133007", "priority_name": "Sometimes" }, { "priority_id": "170876000000133009", "priority_name": "Rarely" }, { "priority_id": "170876000000133011", "priority_name": "Unable" }, { "priority_id": "170876000000133013", "priority_name": "NeverTried" }, { "priority_id": "170876000000133015", "priority_name": "NotApplicable" }], "classification_details": [{ "classification_id": "170876000000133029", "classification_name": "Security" }, { "classification_id": "170876000001829163", "classification_name": "Not a bug" }, { "classification_id": "170876000000133031", "classification_name": "Crash/Hang" }, { "classification_id": "170876000000133033", "classification_name": "DataLoss" }, { "classification_id": "170876000000133035", "classification_name": "Performance" }, { "classification_id": "170876000000133037", "classification_name": "UI/Usabililty" }, { "classification_id": "170876000000133039", "classification_name": "OtherBug" }, { "classification_id": "170876000000133041", "classification_name": "Feature(New)" }, { "classification_id": "170876000000133043", "classification_name": "Enhancement" }, { "classification_id": "170876000001023022", "classification_name": "Support Request" }] } }
问题自定义字段
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/customfields/
获取给定项目中的所有自定义字段。
样本响应
Status: 200 Success Content Type: application/json;charset=utf-8
{ "customfields": [{ "label_name": "SNo", "column_name": "LONG1" }, { "label_name": "Sub Module", "default_Value": "Sales", "column_name": "CHAR3" }, { "label_name": "Browser", "default_Value": "Chrome", "picklist_values": ["Chrome", "Firefox", "IE", "Safari", "Major"], "column_name": "CHAR2" }, { "label_name": "Product", "default_Value": "Code Manager", "picklist_values": ["Mapping Manager", "Code Manager"], "column_name": "CHAR1" }] }
问题活动
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/activities/
获取给定问题中的所有活动。
样本响应
Status: 200 Success Content Type: application/json;charset=utf-8
{ "activity_details": [ { "current_value": "Screen Shot 2016-04-11 at 1.28.05 PM.png", "previous_value": "Screen Shot 2016-04-11 at 1.28.05 PM.png", "action_time_long": 1460361462000, "action_time_format": "04-11-2016 12:57:42 AM", "action": "added", "action_by": "Patricia Boyle", "action_time": "04-11-2016", "action_field": "attachment" }, { "current_value": "End result: Not a router problem. It’s Windows doing it – by design", "action_time_long": 1460361447615, "action_time_format": "04-11-2016 12:57:27 AM", "action": "added", "action_by": "Patricia Boyle", "action_time": "04-11-2016", "action_field": "comment" }, { "current_value": "1460419200000", "previous_value": "", "action_time_long": 1460361181000, "action_time_format": "04-11-2016 12:53:01 AM", "action": "updated", "action_by": "Patricia Boyle", "action_time": "04-11-2016", "action_field": "Resolved Date" }, { "current_value": "External", "action_time_long": 1459289404000, "action_time_format": "03-29-2016 03:10:04 PM", "action": "updated", "action_by": "Patricia Boyle", "action_time": "03-29-2016", "action_field": "flag" }, { "action_time_long": 1455861568000, "action_time_format": "02-18-2016 09:59:28 PM", "action": "updated", "action_by": "Patricia Boyle", "action_time": "02-18-2016", "action_field": "description" }, { "current_value": "Router failure", "previous_value": "router failure", "action_time_long": 1455861568000, "action_time_format": "02-18-2016 09:59:28 PM", "action": "updated", "action_by": "Patricia Boyle", "action_time": "02-18-2016", "action_field": "title" }, { "current_value": "Purchasing", "previous_value": "none", "action_time_long": 1453311828000, "action_time_format": "01-20-2016 09:43:48 AM", "action": "updated", "action_by": "Patricia Boyle", "action_time": "01-20-2016", "action_field": "affected_milestone" }, { "current_value": "Purchasing", "previous_value": "none", "action_time_long": 1453311824000, "action_time_format": "01-20-2016 09:43:44 AM", "action": "updated", "action_by": "Patricia Boyle", "action_time": "01-20-2016", "action_field": "milestone" }, { "current_value": "Data loss", "previous_value": "Feature(New)", "action_time_long": 1453123674000, "action_time_format": "01-18-2016 05:27:54 AM", "action": "updated", "action_by": "Patricia Boyle", "action_time": "01-18-2016", "action_field": "Classification" }, { "current_value": "Jasmine Frank", "previous_value": "Not Assigned", "action_time_long": 1453123674000, "action_time_format": "01-18-2016 05:27:54 AM", "action": "updated", "action_by": "businessrule", "action_time": "01-18-2016", "action_field": "assignee" }, { "current_value": "", "previous_value": "", "action_time_long": 1450442237000, "action_time_format": "12-18-2015 04:37:17 AM", "action": "created", "action_by": "Patricia Boyle", "action_time": "12-18-2015", "action_field": "bug" }, { "current_value": "In progress", "previous_value": "known limitation", "action_time_long": 1450442237000, "action_time_format": "12-18-2015 04:37:17 AM", "action": "updated", "action_by": "businessrule", "action_time": "12-18-2015", "action_field": "status" } ] }
获取重命名值
GET /portal/[PORTALID]/projects/[PROJECTID]/bugs/renamedfields/
获取默认字段的重命名值。
Status: 200 Success Content Type: application/json;charset=utf-8
{ "renamed_fields": [{ "actualname": "severity", "replacedname": "Severity" }, { "actualname": "classification", "replacedname": "Classification" }, { "actualname": "isitreproducible", "replacedname": "Is it Reproducible" }, { "actualname": "module", "replacedname": "Module" }] }