各位开发者朋友们,大家好。
为解决 API 对接存在的重复封装、手动计算签名、框架适配繁琐等问题,同时考虑到 ISAS 以 PHP 开发者为主,我们决定优先上线 ISAS 官方 PHP SDK。
该SDK兼容原生PHP及Larael、ThinkPHP 6.x/8.x、Hyperf、Symfony、Yii2等主流框架,少量代码即可快速调用平台接口,大幅降低接入门槛。目前该项目已上线GitHub同步开源,后续我们还将推出Python、Java等多语言SDK,持续完善技术生态,助力开发者分钟级完成 API 对接。
核心特性
全局仅需引入一个“Client”入口,所有子服务链式直达,开发者无需声明臃肿的use头部,让代码更简洁清爽。同时我们也保留了独立服务实例调用的方式,满足不同的开发习惯。
“Client”
Client
use
全面移除硬编码风险,采用构造函数动态注入凭证,完美支持环境变量配置,让您的 API 密钥安全可控,从源头避免密钥泄漏的安全隐患。
完全符合 PSR-4 规范,未调用的组件绝不加载,即使面对平台海量的扩展能力,也能保持零内存浪费,完全不会影响您原有项目的性能表现。
内置完整的错误拦截机制,统一处理网络异常、参数错误、服务调用异常等各类问题,提供优雅的调试体验,帮您快速定位问题,减少排错时间。
SDK 原生封装了平台标准化的动态签名逻辑,开发者无需手动编写复杂的签名校验与加密计算代码,开箱即用,彻底告别对接时的签名调试痛点,大幅降低对接成本。
我们推荐通过 Composer 进行标准安装,只需在您的项目根目录执行一行命令即可完成安装:
composer require isas/php-sdk
无需复杂配置,只需三步即可完成您的首次接口调用:
首先引入 Composer 自动加载,然后初始化 SDK 客户端,填入您在平台申请的 API 凭证:
<?php // 引入Composer自动加载 require_once __DIR__ . '/vendor/autoload.php'; // 引入SDK核心客户端(起别名避免与其他类名冲突) use Isas\Sdk\Client as IsasSdk; // 填入您的平台凭证 $token = 'YOUR_API_TOKEN'; // 替换为您的真实API Token $appSecret = 'YOUR_APP_SECRET'; // 替换为您的真实AppSecret(未开启动态签名服务可为空) // 实例化SDK客户端 $isas = new IsasSdk($token, $appSecret);
以 UUID 批量生成接口为例,只需简单的链式调用即可完成请求,SDK 会自动帮您处理签名、请求等所有底层逻辑。
try { // 链式调用Develop服务下的UuidGenerator方法 // 参数说明:生成2个UUID v4版本,使用默认格式 $uuidResponse = $isas->Develop()->UuidGenerator(2, 4, 'default'); // 处理返回结果 if (isset($uuidResponse['code']) && $uuidResponse['code'] === 200) { echo "接口请求成功!"; print_r($uuidResponse['data']); } } catch (\BadMethodCallException $e) { // 拦截服务不存在、拼写错误等组件调用异常 echo "服务调用异常:" . $e->getMessage(); } catch (\Throwable $e) { // 拦截网络、系统等全局异常 echo "系统异常:" . $e->getMessage(); }
目前平台每个API服务详情页面,均已单独标注对应的SDK专属调用方法名称及DEMO示例,大家可直接对照页面名称精准调用,无需自行匹配、猜测方法名,大幅降低对接出错概率。
通过本 SDK,您可以一键调用平台上的所有开放能力,覆盖研发、数据、工具等多个场景,包括但不限于:
AI 能力:各类 AI 文本处理、图像生成等智能服务
研发工具:UUID 生成、常用加密解密等研发辅助工具
新闻资讯:全网新闻数据查询、资讯聚合服务
热点榜单:各大平台热搜、热点榜实时数据
健康管理:健康相关数据查询与管理服务
网站工具:网站性能检测、信息查询等工具服务
更多能力持续更新中,后续平台新增的能力,您只需更新 SDK 即可直接调用,无需额外修改对接代码。
报错 Class "Isas\Sdk\Services\XXX" not found 怎么办?
这通常是 Composer 自动加载缓存过期或者本地文件不完整导致的。您可以在项目根目录执行以下命令刷新自动加载缓存:
composer clear-cache composer dump-autoload -o
如果您觉得这个 SDK 对您有帮助,欢迎前往 GitHub 仓库给我们点亮 Star,您的支持是我们持续更新的动力!
GitHub 仓库地址:https://github.com/ISAS-DATA/isas-php-sdk
如果您在使用过程中遇到任何问题,或者有任何建议,欢迎:
在 GitHub Issues 提交问题反馈
通过平台联系我们的技术支持团队
我们也欢迎所有开发者提交 PR,共同完善这个 SDK,一起打造更好的PHP开发体验!
未来,我们还会陆续推出更多语言的官方 SDK,覆盖 Python、Java 等主流开发语言,打造全语言的开发生态,让不同技术栈的开发者都能快速对接ISAS平台的能力,感谢各位开发者们的支持!