2016 - 2024

感恩一路有你

怎么使用php调用api接口 http服务接口怎么设计?

浏览量:4408 时间:2023-07-06 18:08:57 作者:采采

http服务接口怎么设计?

如果是提供给客户端远程调用的API,可以参考下以下的最佳接口开发实践。

(1)接口风格和协议的选择 - HTTP

(2)接口域名 - 使用api单独域名

(3)异常处理 - 200/400/500三大接口结果状态码

(4)对外的命名规则 - 使用小写加下划线

(5)对内的命名规则 - 使用驼峰法和遵循PEAR命名

(6)安全与验证 - 使用接口签名和token登录态双重机制

(7)返回结果格式 - JSON

(8)URL规则与路由映射 - 统一service接口服务,可一个文件一个接口

(9)SDK包 - 给客户端自由的调用空间和自由

(10)接口文档 - 使用markdown快速编写

(11)测试驱动开发 - 坚持单元测试

追到一个心仪的女生不难,难于如何保持和培养一份真挚的感情;获得一时的财富也不难,难于如何长久保持收益;创业的公司很容易博得一时媒体的关注以及某次天使的投资,但难于如何排除各种障碍、充分利用各方资源发展成中企业及至上市公司。

同样,提供一时的接口很容易,但当我们需要不断为接口提供升级,以及当我们维护提供一整套接口时,面临的困难和问题会越来越大。

所以,这是一场持久的战役。需要我们用稳重的心态、专业的能力在背后持久支撑、推动。

目前,后台接口开发可以用RESTFull风格,也可以用Web Service;可以用SOAP协议、RPC协议,也可以用HTTP协议;可以用短链接,也可以使用长链接。如果我们希望继续进行划分,还可以分为同步或异步、单个或批量、是否有SDK包、内部接口还是开放接口平台等。

现在看来,大部分大型的企业以及大多数的小公司使用的都是HTTP协议下的接口开发,部分使用RESTFull,但Web Service较少。

这部分内容可能比较老了,但我觉得还有参考价值的,更多可以查看:PhalApi(π框架) - PHP轻量级开源接口框架 - 接口,从简单开始!

phpsdk怎么开始开发?

你有自己的网站,想开发一个php的sdk,然后开放出去给别人调用。

你已经下载了别人的sdk,然后想基于该sdk开发自己的应用。

第一种情况,无非是写一些开放接口,让别人可以对你网站进行有限的读写操作。

第二种情况很常见。最常见的就是我们下载微博的sdk,然后开发自己的应用。如果是这样,你可以多参考sdk的wiki页面,上面一般都有实例代码。 最外层包含:配置文件, 鉴权和一些公共的函数。

HTTP 目录主要包含了一些对 http 进行封装的类,这块你可以不用关心。

Storage 目录主要包含两大块:Bucket 中文件的管理和文件的上传。

Processing 目录主要包含文件的处理,文件处理又包含两个方面:同步处理和异步处理。

Cdn 目录主要包含了 CDN 的相关 API ,有文件的刷新和预取,CDN 日志的下载等方法。

接口 文件 协议 公司 sdk

版权声明:本文内容由互联网用户自发贡献,本站不承担相关法律责任.如有侵权/违法内容,本站将立刻删除。