兼容写法：也可直接将参数 token / sign / timestamp / nonce 拼接在URL参数中（参数说明请对应上方，Token无需“Bearer”），不建议此方式，安全性较低，容易泄露隐私数据。
该API可广泛接入各类娱乐互动类产品中——如在线KTV、语聊房、语音电台App中用作"随机点歌""摇一摇换歌"功能，为房间营造轻松氛围；个人博客或H5小游戏可嵌入为背景BGM自动切换，提升页面趣味性；小程序中的休闲互动模块、短视频拍摄辅助工具也可调用此接口获取流行弹唱片段供用户试听或参考。适合社交娱乐平台、音乐类工具App、个人开发者练手项目及轻量级Web应用快速集成使用。
适用于： Laravel / ThinkPHP 6.x 8.x / Hyperf / Symfony / Yii2 / Slim / CodeIgniter4 等主流 PHP 框架及原生 PHP 项目，更多语言SDK陆续开发中。
composer require isas/php-sdk
git clone https://github.com/ISAS-DATA/isas-php-sdk.git
use Isas\Sdk\Client as IsasSdk; $isas = new IsasSdk($token, $appSecret); $isas->Tools()->singduckRandomSong();
use Isas\Sdk\Client as IsasSdk; $isas = new IsasSdk($token, $appSecret); $Tools = new \Isas\Sdk\Services\Tools($isas); $Tools->singduckRandomSong();
<?php require_once __DIR__ . '/vendor/autoload.php'; // 引入SDK核心客户端（起别名避免与其他类名冲突） use Isas\Sdk\Client as IsasSdk; // 配置你的凭证 $token = 'YOUR_API_TOKEN'; // 替换为您的真实API Token $appSecret = 'YOUR_APP_SECRET'; // 替换为您的真实AppSecret（未开启动态签名服务可为空） // 初始化客户端 $isas = new IsasSdk($token, $appSecret); // 调用 [ 唱鸭随机点歌服务 ] 服务接口 // 方式一：链式极简调用（基于动态代理魔术方法（__call）实现子服务路由切换） $response = $isas->Tools()->singduckRandomSong(); // 方式二：独立服务实例调用（显式实例化服务组件，适用于提供 IDE 强类型代码补全提示的场景） // $Tools = new \Isas\Sdk\Services\Tools($isas); // $response = $Tools->singduckRandomSong(); // 原生JSON输出结果 //echo json_encode($response, JSON_UNESCAPED_UNICODE); //判断状态码输出结果 if ($response['code'] === 200) { print_r($response['data']); } else { echo "错误：" . $response['message']; } ?>
