查看注册信息

2017-08-31

模块功能

分析注册工具APP的用户需求，注册人和审批人都需要查看注册信息，所以我们首先开发这个模块。这部分需求功能分解后有以下内容：

审批人和注册人查看注册信息列表，按提交时间顺序排列最新提交的在上方，列表初始最多显示50条信息；
审批人和注册人下拉列表刷新注册信息；
审批人和注册人上拉列表加载更多数据，每次最多加载50条；
审批人和注册人用项目名称搜索注册信息；
审批人同意或拒绝注册信息；
审批人编辑审批状态；

界面设计

API

界面设计完成后确定了数据的获取方式，就可以制定服务端提供的API接口了。这次需要用到以下API：

获取注册信息列表
获取注册信息详情
修改注册信息的授权状态

服务器为APP提供的API使用接口需使用HTTPS协议、JSON数据格式、UTF8编码。

获取注册信息

GET api/license?access_token=ACCESS_TOKEN&beginId=1232

按创建日期降序排列获取所有的注册信息，每次获取50条。将最后一条的id通过beginId传入，可以获取后续50条。

参数说明： | 参数 | 必填 | 说明 | |———|—–|————————————————| | beginId | 否 | 按创建时间降序排列，获取从此ID以后50条记录，不包含该ID。不填写表示获取最新的50条。 |

返回值：

200 OK

[
    {
        "id":1234,
        "projectName":"xxx销售合同",
        "product":"安全防范管理系统",
        "isTrial":true,
        "expire":"2017-09-01 14:00:00",
        "description":"50用户 专业版",
        "note":"用户演示注册",
        "creationTime":"2017-08-01 14:11:28",
        "creationBy":"张三",
        "status":3,
    },
    {...}
]

获取注册详情

GET api/license/{id}?access_token=ACCESS_TOKEN

参数	必填	说明
id	是	注册信息id。

返回值：

200 OK

{
    "id":1234,
    "contractCode":"1234-23124",
    "projectName":"xxx销售合同",
    "product":"安全防范管理系统",
    "isTrial":true,
    "expire":"2017-09-01 14:00:00",
    "description":"50用户 专业版",
    "note":"用户演示注册",
    "creationTime":"2017-08-01 14:11:28",
    "creationBy":"张三",
    "status":3,
    "audit":[{
        "auditor":"李四",
        "approved":false,
        "note":"合同号不存在"
    }]
},
{...}

设置注册授权状态

PUT api/license/{id}?access_token=ACCESS_TOKEN

参数	必填	说明
id	是	注册信息id。
approved	是	true表示同意注册，false表示拒绝注册
note	否	拒绝时填写原因

请求参数：

{
    "approved":true,
    "note":"同意"
}

返回值：

200 OK

{
    "id":1234,
    "status":3,
    "audit":[{
        "auditor":"李四",
        "approved":true,
        "note":"同意"
    }]
}