tp官方正版下载接口文档详解
我们的团队, 于对接ThinkPHP官方正版下载系统之际, 整理出了这套常用接口文档 ,这些接口包含了用户认证功能tp官方正版下载的常用接口文档, 包含了版本识别功能, 包含了下载链接生成等核心功能, 此乃开发者集成官方下载服务时必备的参考。
整个系统的入口是用户认证接口,调用之际要携带应用密钥以及时间戳, 借由HMAC -SHA256算法去生成签名, 返回的access_token有效期为2小时, 推荐存储在缓存里作重复使用, 这个接口的调用频率限制是每分钟30次, 超出便会返回429状态码。
有一种接口叫版本识别接口, 它能够获取到那个最新的官方版本号。我们会作出推荐, 在应用进行启动之时去自动调用它, 而后把返回的版本号拿来和本地做对比；被这个接口给返回出来的数据之中, 涵盖了版本名称、构建日期以及MD5校验值等各类字段情况。特别是需要着重注意, 该历史版本列表在默认的状态下仅仅只会返回最近的那5个, 假如还想要获取其他更多些资源, 就得必备分页参数才行。
生成下载链接的接口, 要传入版本号以及操作系统类型, 系统会返回一个临时ownload链接地址, 该地址有效期仅仅只15分钟, 实际测试发现, 这个地址凭借CDN达成加速, 在国内进行下载时速度能够达到10MB每秒以上,要是返回的地址不能够进行访问tp官方正版下载接口文档详解, 可以尝试再次生成。
有误的代码标识处置是时常会被忽略无视弃置丢下的部分, 1001意味着签名已经逾期, 1002指代权限有所欠缺不足, 1003表明版本目前并不存在处于缺失状态 , 我们给出提议建议在代码当中构建创立造起错误码映射表格, 碰到遇到察觉到异常状况情形的时候能够快速迅即地确定找到定位问题所在之处 , 接口返回来的错误消息资讯信息是均为中英文两种语言, 便利方便利于国际化应用程序开发。
几个细节最后再提醒一下: 所有接口请求头部必填User - Agent字段, 官方提供的SDK 版本号建议使用；响应数据采取UTF - 8编码进行统一；接口一旦变更提前一个月会在开发者社区予以公告。官方更新日志建议定期进行查看, 以此确保接口调用始终保持兼容状态。
