接口基础

PR系统支持API功能，API仅支持网络版。若您想实现房租管理智能化，可以使用本API实现。

启用接口

要启用API，需要先登录PR网络版，找到API设置菜单，将API功能设置为选用，即完成对API功能启用。

API KEY和API Secret请妥善保管，一旦泄露将导致您的文档系统可被第三方恶意修改。

若发现被泄露，请点击刷新API按钮。

接口全局说明

接口根据Restful规则进行编写，PR系统提供了四个请求类型：

因此，您在调用接口时，请发起对应的请求。

Headers鉴权

所有接口都通过headers存放api key 和 api secret 进行鉴权。请求格式如下：

Authorization的组成需要将key和secret按照上表示例格式进行base64转换，在前缀带上Bearer+空格+base64转换后的字符串

例如上图base64转换后的字符串为：NU5XeEVKYmRaN3ZoYVpaQmxmVTVZdUQ1WHN0Umtodkk6ZkdzNkRRRG51VmRGV3NWY3RrYlVIQWZMcmZEQlh1aVE=

header填写的value则是：Bearer NU5XeEVKYmRaN3ZoYVpaQmxmVTVZdUQ1WHN0Umtodkk6ZkdzNkRRRG51VmRGV3NWY3RrYlVIQWZMcmZEQlh1aVE=

发送数据格式

向所有接口发送数据都是JSON字符串。

返回格式和状态

API所有返回信息均为JSON。

PR系统API请求成功下，一般只返回0和其他数字状态码，常见的302、401、404、500等等均会以HTTP状态码一并返回。