首发于

　　RESTful本身是一种风格而不是规范，本文为该风格的规范实现的最佳实践，本文档详细说明了HTTP RESTful API的定义和使用规范，作为接口调用者和实现者的重要参考。

　　遵循RESTful设计风格，同时控制复杂度及易于使用，仅遵循大部分原则。 遵循原则：

　　使用https协议

　　版本号放入URL

　　只提供json返回格式

　　post,put上使用json作为输入wps 官网的下载地方是什么

　　使用http状态码作为错误提示

　　Path（路径）尽量使用名词，不使用动词，把每个URL看成一个资源

　　使用HTTP动词（GET,POST,PUT,DELETE）作为action操作URL资源

　　过滤信息

　　limit：指定返回记录数量

　　offset：记录开始位置

　　direction：请求数据的方向，取值prev-上一页数据；next-下一页数据

　　page：第几页

　　per_page：每页条数

　　total_count：总记录数

　　total_pages：总页数，等于page时，表示当前是最后一页

　　sort：column1,column2排序字段

　　orderby：排序规则，desc或asc

　　q：搜索关键字（uri encode之后的）

　　返回结果

　　GET：返回资源对象

　　POST：返回新生成的资源对象

　　PUT：返回完整的资源对象

　　DELETE：返回一个空文档

　　速率限制

　　X-RateLimit-Limit: 每个IP每个时间窗口最大请求数

　　X-RateLimit-Remaining: 当前时间窗口剩余请求数

　　X-RateLimit-Reset: 下次更新时间窗口的时间（UNIX时间戳），达到下个时间窗口时，Remaining恢复为Limit

　　未遵循原则：

　　Hypermedia API（HATEOAS），通过接口URL获取接口地址及帮助文档地址信息

　　限制返回值的域，fields=id,subject,customer_name

　　缓存，使用ETag和Last-Modified

　　参考：

　　接口模块相互对立且有版本管理，模块名作为APP配置项进行存储，每个模块的版本号version和endpoint在应用初始化时调用api模块信息接口（通过传递客户端应用名称和版本号获取各个API模块的endpoint和version）获取并存储。

　　示例模块及最新版本号：

　　公共请求参数是指每个接口都可能需要传递的参数，公共参数通过header传递。

　　Web应用通过cookies传递session id，user_id和token无需传递，接口会从session自动获取；

　　同一token值在App和Web各应用间通用（token即为session id）；

　　APP修改user-agent，在原有user-agent的尾部添加和。如：

　　app取值及释义示例

　　app取值客户端名称【域名】admin-pc管理中心PC网页版【】admin-h5管理中心官方最新版wps的下载网站是多少手机网页版【】admin-ios管理中心iOS版admin-android管理中心Android版

　　用于告知服务端是否支持Webp的Cookie：cookie name是，取值是1（支持）和0（不支持），未传递时服务端默认取值为0wps 官网的下载的网址。

　　Webview植入Session的Cookie：

　　可用于替代session-cookie机制。但会存在一些问题，比如为过期token强制失效问题（用户修改了密码后，无法强制其他的终端token全部失效）。

　　权限分为

　　：无需任何授权；

　　：需要用户登录授权，可通过和传递；

　　：需要管理员登录授权，可通过和传递；

　　：用户登录授权或管理员登录授权都可以；

　　：需要签名，一般用于服务端内部相互调用，详见。

　　正确

　　接口正常访问情况下，服务器返回2××的HTTP状态码。

　　错误

　　当用户访问接口出错时，服务器会返回给一个合适的4××或者5××的HTTP状态码；以及一个application/json格式的消息体，消息体中包含错误码code和错误说明message。

　　5××错误()为服务器或程序出错，客户端只需要提示“服务异常，请稍后重试”即可，该类错误不在每个接口中列出。

　　4××错误()为客户端的请求错误，需要根据具体的code做相应的提示和逻辑处理，message仅供开发时参考，不建议作为用户提示。

　　部分错误示例：

　　遵循RESTful规范，使用了GET, POST, PUT, DELETE共4种请求方法。wps office 官方的下载的网址

　　GET：请求资源，返回资源对象

　　POST：新建资源，返回新生成的资源对象

　　PUT：新建/更新资源，返回完整的资源对象

　　DELETE：删除资源，返回body为空

　　GET请求不允许有body， 所有参数通过拼接在URL之后传递，所有的请求参数都要进行遵循的URL Encode。

　　DELETE删除单个资源时，资源标识通过path传递，批量删除时，通过在body中传递JSON。

　　POST, PUT请求，所有参数通过JSON传递，可选的请求参数，只传有值的，无值的不要传递，contentType为application/json。

　　4种请求动作中，GET、PUT、DELETE是幂等的；只有POST是非幂等的。幂等操作的特点是其任意多次执行所产生的影响均与一次执行的影响相同。 是非幂等是判断接口使用POST还是PUT的决定条件

　　注意： APP端获取json数据时，对于数值类型字段必须以数值类型转换，无论传递过来的值是否带引号。

　　为了防止API被恶意调用，对API调用进行速率限制。

　　速率限制为每IP每15分钟5000次（dev/qa为10W）调用（15分钟是一个时间窗口）。

　　限制是针对孩宝所有接口模块一起计算的（Redis key为），暂时没有特殊的模块或单个接口（未来可能有）。

　　你可以通过每个接口返回的HTTP headers了解当前速率限制的情况:

　　X-RateLimit-Limit: 每个IP每个时间窗口最大请求数

　　X-RateLimit-Remaining: 当前时间窗口剩余请求数

　　X-RateLimit-Reset: 下次更新时间窗口的时间（UNIX时间戳），达到下个时间窗口时，Remaining恢复为Limit

　　超出速率限制，返回以下错误

　　wps中文最新版下载的地址是什么

　　用户登录后用户的token；aliyun OSS的bucket、AccessKey ID与AccessKey secret；微视频的appid、sign、bucket；这些关键数据通过调用接口获得，需要在客户端以安全的方式存储wps office 的官方下载的地方。

　　音频视频在APP内的存储，不允许被拷贝（即使越狱或root后拿走也无法使用）。

　　推荐Chrome浏览器插件Postman作为接口测试工具， 

　　生成的工具为apidoc，详细阅读官方文档：

　　伪代码

　　PHP

　　无障碍wps下载网址

　　App配置文件中仅存储api模块名，App初始化时请求，获取各个api模块的信息（endpoint和version）。