PHP 如何更优雅地调用 API 接口

API 接口在各种场景中已经非常普遍使用，通常在 PHP 后台调用 API 接口，需要通过 Curl 库来自己封装，且不说各种充值门槛，还要被各种 api 接口平台的 appKey 、appSecret 之类的参数困惑，没法实现统一调用，很多小白更是被 Curl 各种配置参数弄得头大。ThinkPHP官方出品的ThinkAPI服务正是为了解决 PHP 接口调用的各种麻烦问题。

ThinkAPI统一API接口服务是由官方联合合作伙伴封装的一套接口调用服务及 SDK，旨在帮助ThinkPHP开发者更方便和更低成本调用官方及第三方的提供的各类API接口及服务，从而更好的构建开发者生态。

通过ThinkAPI提供的 SDK 功能可以以更优雅的方式来调用 API 接口，首先需要在你的项目里面安装 think-api 库（适用于任何 PHP5.6+项目，没有任何框架要求）。

composer require topthink/think-api

然后就可以调用你需要的接口进行查询和返回数据，支持ThinkAPI所有的 API 接口，以查询身份证所属地区接口为例：

use think\api\Client;

$client = new Client("appCode");

$result = $client->idcardIndex()
    ->withCardno('身份证号码')
    ->request();

idcardIndex方法就是调用了身份证归属地查询接口 withCardno方法则表示传入了cardno参数，如果还需要传入更多的参数则链式调用更多的方法即可，最后通过request方法进行实际调用并返回数据。通过 IDE 配合的话，你不需要自己记住任何接口方法名和参数方法名，都会有自动提示。

ThinkAPI所有的 API 调用服务必须设置appCode值（只需要注册一个账号即可获取），用于接口调用的身份认证。如需多次调用的话，建议自己在项目里面封装一个助手函数，例如：

use think\api\Client;

/**
 * API 接口调用助手函数
 * @return Client
 */
function api(): Client
{
    return new Client('yourAppCode');
}

// 调用示例
$result = api()->idcardIndex()
    ->withCardno('身份证号码')
    ->request();

所有的接口服务和方法都支持 IDE 自动提示和完成（请务必注意方法大小写必须保持一致），所有的返回数据都是 JSON 格式，因此基本上不需要文档即可完成接口开发工作。API 接口调用中的一些常见问题通过系统的方法封装都可以规避掉，你甚至不需要关心接口是要用 GET 还是 POST，都是系统自动处理的。

SDK 把所有接口和参数都封装为一个个独立的方法，你可以像调用一个类的方法一样简单的调用官方支持的任何 API 接口，也无需再去记住每个接口的参数有哪些。

如果你的环境不支持 Composer 或者 PHP 版本过低，可能需要你自己封装 Curl 库来调用接口。ThinkAPI 接口文档都提供了两种方式调用：直接调用接口地址和使用 SDK 调用。

目前 ThinkAPI 已经接入包括实名认证、人工智能、电子商务、新闻资讯和生活服务等类目在内的常用 API 接口共 269 个，包含大量免费接口，付费接口的价格比较实在、门槛也低，并且还在陆续扩充中。更详细的用法可以参考： https://docs.topthink.com/think-api