feedbackInfos

URI

<portal_uri>/feedback[.<format>]

支持的方法

GET、POST、DELETE、HEAD

父资源

portal

子资源

feedbackInfo

介绍

feedbackInfos 资源是意见反馈列表信息，支持查询意见反馈列表，支持添加新的意见反馈，支持批量删除意见反馈。

支持的方法：

支持的表述格式：RJSON、JSON、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiportal 是服务器名。

http://supermapiportal:8190/iportal/web/feedback.rjson

GET 请求

查询意见反馈列表信息。

请求参数

如果参数未设置，则返回当前用户有权限查看的当前第一页中的意见反馈信息，设置参数后，会返回用户指定的意见反馈列表信息，请求参数必须包含在 URI 中。

名称 类型 含义
currentPage int 根据分页页码过滤。
keywords String[] 根据关键字查询。
orderBy FeedbackOrderBy 排序结果升序/降序展示。
orderType OrderType 根据排序字段过滤。
pageSize int 分页中每页大小。
replied Boolean 根据是否已回复过滤。
reviewStatus ReviewStatus 根据审核状态过滤。
userName String 根据反馈者用户名过滤。

响应结构

对 feedbackInfos 资源执行 GET 请求，返回意见反馈列表信息。由以下字段组成：

字段 类型 说明
currentPage int 当前第几页。
content List<FeedbackInfo> 页面内容。
pageSize int 每页大小。
searchParameter SearchParameter 当前页搜索参数。
total int 总记录数。
totalPage int 总页数

响应示例

对 feedbackInfos 资源：http://localhost:8190/iportal/web/feedback.rjson 执行 GET 请求，返回 rjson 格式的资源表述如下：

{

    "total": 2,

    "totalPage": 1,

    "pageSize": 9,

    "searchParameter": {

        "orderType": "ASC",

        "keywords": null,

        "replied": null,

        "orderBy": null,

        "pageSize": 9,

        "reviewStatus": "PASSED",

        "userName": null,

        "currentPage": 1

    },

    "currentPage": 1,

    "content": [

        {

            "replied": false,

            "updateTime": 1589156955302,

            "reviewer": null,

            "userName": "admin",

            "title": "test",

            "reviewComments": null,

            "content": "test",

            "replyTime": null,

            "reviewerNickname": null,

            "createTime": 1589156955302,

            "name": "admin",

            "contactNumber": null,

            "reviewStatus": "PASSED",

            "id": 122398488,

            "replier": null,

            "replyContent": null,

            "email": "wangzhe@supermap.com",

            "reviewTime": null,

            "replierNickname": null

        },

        {

            "replied": false,

            "updateTime": 1588941927741,

            "reviewer": null,

            "userName": "admin",

            "title": "移动端",

            "reviewComments": null,

            "content": "移动端适配不是很好",

            "replyTime": null,

            "reviewerNickname": null,

            "createTime": 1588941927741,

            "name": "user",

            "contactNumber": null,

            "reviewStatus": "PASSED",

            "id": 432329231,

            "replier": null,

            "replyContent": null,

            "email": "",

            "reviewTime": null,

            "replierNickname": null

        }

    ]

}

如果希望获取指定条件的意见反馈列表信息，如根据意见反馈标题的关键字符过滤，则需要设置 keywords=["iPortal"]，即对 feedbackInfos 资源：http://localhost:8190/iportal/web/feedback.rjson?keywords=["iPortal"] 执行 GET 请求，返回的 rjson 格式的资源表述如下：

{

    "total": 1,

    "totalPage": 1,

    "pageSize": 9,

    "searchParameter": {

        "orderType": "ASC",

        "keywords": [

            "iPortal"

        ],

        "replied": null,

        "orderBy": null,

        "pageSize": 9,

        "reviewStatus": "PASSED",

        "userName": null,

        "currentPage": 1

    },

    "currentPage": 1,

    "content": [

        {

            "replied": true,

            "updateTime": 1590563366467,

            "reviewer": "admin",

            "userName": "user",

            "title": "iPortal Test",

            "reviewComments": "通过",

            "content": "Have a Test",

            "replyTime": 1592292396994,

            "reviewerNickname": null,

            "createTime": 1590563366467,

            "name": "user",

            "contactNumber": null,

            "reviewStatus": "PASSED",

            "id": 865402370,

            "replier": "admin",

            "replyContent": "support",

            "email": "user@supermap.com",

            "reviewTime": 1591175349421,

            "replierNickname": null

        }

    ]

}

POST 请求

添加一条新的意见反馈。

请求参数

发送请求时，需要在请求体中传递如下参数：

字段 类型 说明
contactNumber String 反馈者联系电话。
content String 意见反馈内容。
email String 反馈者邮箱。
name String 反馈者姓名。
title String 意见反馈标题。

响应结构

返回的资源表述结构如下：

字段 类型 说明
newResourceID String 添加的意见反馈的 id。
newResourceLocation String 添加的意见反馈的 URI。
succeed boolean 添加意见反馈是否成功。

 

响应示例

对 feedbackInfos 资源:http://localhost:8190/iportal/web/feedback.rjson 执行 POST 请求，添加一条新的意见反馈，发送请求体如下：

{

    "name": "user",

    "email": "user@supermap.com",

    "title": "Test",

    "content": "test!"

}

则返回的 rjson 格式响应结果如下：

{

    "newResourceID": "1146584947",

    "succeed": true,

    "newResourceLocation": "http://rdc.ispeco.com/web/feedback/1146584947"

}

DELETE 请求

删除意见反馈，支持批量删除意见反馈。url 中传递需要删除的反馈的 id 数组。

响应结构

返回的资源表述结构如下：

字段 类型 说明
succeed boolean 删除意见反馈是否成功。
error Httperror 出错信息，如果删除反馈成功，则没有本字段。

响应示例

对 feedbackInfos 资源：http://localhost:8190/iportal/web/feedback.rjson?ids=[1,2] 执行 DELETE 请求，批量删除 id 为 1 和 2 的两条反馈，返回的 rjson 格式响应结果如下：

{ "succeed": true}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 feedbackInfos 资源是否存在，或者客户端是否有权限访问 feedbackInfos 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 feedbackInfos 资源是否支持<format>格式的表述。

请参见