sdk接入php技巧_ThinkAPI做事SDK正式宣告

对付一些付费的接口，官方的做事市场供应了更优惠的价格。

无论是免费还是付费接口，都须要通过AppCode授权后才能进行接口要求。
AppCode的值可以在官方做事市场->个人中央->API管理的上方查询到，每个用户账号拥有一个唯一的AppCode值（请不要随意透露）。

可以利用两种方法进行身份认证：

在要求Header中添加的Authorization字段，配置值为“AppCode ＋ 半角空格 ＋AppCode值”。

格式如下：

Authorization:AppCode AppCode值第二种：要求参数认证

要求Query中添加的appCode参数，参数的值为用户AppCode的值。

https://API接口地址?appCode=AppCode值原生API调用

ThinkAPI所有支持的接口做事都有一个唯一的接口调用地址，这个接口地址统一利用https://api.topthink.com 作为接口网址，例如身份证查询接口的要求地址是：

https://api.topthink.com/idcard/index

你可以通过下面的要求来调用接口

https://api.topthink.com/idcard/index?appCode=AppCode值&cardno=要查询的身份证号码

你可以在注册市场账号后测试下这个免费接口，查看详细的返回数据。

把稳：部分接口可能采取不同的要求类型，不一定是GET要求，详细的接口参数请参考详细的API文档，会有详细的解释。

返回数据格式

所有的api接口返回数据规范如下：

名称类型解释codeint返回码,0 表示成功 其它表示失落败messagestring返回提示信息dataobject返回数据

当code为0的时候计费，个中data包含的数据和详细的接口有关。

利用SDK调用

除了利用原生的办法调用接口外，ThinkAPI还供应了一套通用的SDK接口规范，让你用更简洁和当代化的办法调用接口做事。
利用方法如下：

首先须要在你的项目里面安装think-api库

composer require topthink/think-api

建议设置利用阿里云 Composer 全量镜像

然后就可以调用你须要的接口进行查询和返回数据，还是以上面的查询身份证所属地区接口为例解释：

use think\api\Client;// API调用之前必须设置`AppCode`值，用于接口调用的身份认证$client = new Client("YourAppCode");// 调用某个接口方法和传入参数$result = $client->idcardIndex() ->withCardno('身份证号码') ->request();var_dump($result);

所有的接口做事和方法都支持IDE自动提示和完成（请务必把稳方法大小写必须保持同等 确保参数名的精确性），基本上不须要文档即可完成接口开拓事情。

上面是免费接口的SDK调用示例，付费接口的调用办法是完备一样的，差异在于付费接口你必须要先在市场购买接口次数才能正常调用（ThinkAPI做事的接口必须在官方市场购买才有效，第三方购买的接口是不支持调用的），而免费接口则有每天不超过100次要求的限定。

下面是身份证明名认证的接口调用示例：

$client = new Client("YourAppCode");$result = $client->idcardQuery() ->withIdcard('身份证号码') ->withRealname('姓名') ->request();var_dump($result);

把稳，该SDK做事仅支持官方已经接入的API接口，目前接口数量正在扩充中，你可以联系我们反馈你须要的API接口，我们来统一进行接入。

成为API供应商

面向做事开拓将是将来的一大开拓趋势，如果你操持在100万+的ThinkPHP开拓者中推广你们的做事，欢迎联系！
诚邀互助伙伴（包括但不限于API做事商或对外供应开放API的产品做事商）加入官方统一API接口做事操持。

联系我们

成为API供应商或者反馈你须要的API接口请联系微信topthink（注明来意）。

标签：接口调用