ThinkAPI服务SDK正式发布
在官方不久前宣布提供统一API接口服务之后，SDK接口现在也已经正式发布了1.0版本。
ThinkAPI服务介绍
开发者经常为了各种功能而四处寻找是否有相应的API接口，即便找到了可能还要忍受第三方各种奇葩的SDK调用，或者不支持composer安装。
ThinkAPI统一API接口服务是由官方联合合作伙伴封装的一套接口调用服务及SDK，旨在帮助Thinkphp开发者更方便的调用官方及第三方的提供的各类API接口及服务，从而更好的构建开发者生态。
一站式接口服务
ThinkAPI提供了一站式的接口服务，从接口购买、调用到SDK封装都只需要一个官方账号即可完成，无需注册各种接口服务账号，除了涵盖常用API服务之外，还设计了可转换接口服务更好的保障接口的稳定性，让你省心省力。
提供统一的SDK
官方提供了一套统一的SDK for PHP调用服务，通过composer安装一个轻量级的依赖包即可调用，采用简洁和现代化的调用方式，并且对IDE友好，可以简化你的API调用开发工作。
官方服务市场保障
ThinkAPI所有支持的接口都纳入官方服务市场，包括免费接口和付费接口，市场服务有保障，并且有购买记录以及统计数据。
对于一些付费的接口，官方的服务市场提供了更优惠的价格。
身份认证（AppCode）
无论是免费还是付费接口，都需要通过AppCode授权后才能进行接口请求。AppCode的值可以在官方服务市场->个人中心->API管理的上方查询到，每个用户账号拥有一个唯一的AppCode值（请不要随意泄露）。
可以使用两种方法进行身份认证：
第一种：Header信息认证（推荐）
在请求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 thinkapiClient;
// 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（注明来意）。
