APISpace 语音通知 API接口 PHP调用示例代码

该示例代码适用于 www.apispace.com 网站下 API，使用该产品前，您需要通过以下链接订阅服务：https://www.apispace.com/chuanglan/api/253-notify-vocie/api/ APISpace 提供的语音通知 API 是一种便捷的通信服务，允许开发者通过 PHP 脚本向指定的电话号码发送语音消息。这种服务在需要快速、直观的通知用户时非常有用，比如验证码验证、订单提醒或者紧急通知。下面将详细介绍如何使用 APISpace 的语音通知 API 接口以及 PHP 调用示例。 为了使用这些 API，你需要在 APISpace 的官方网站（https://www.apispace.com）上订阅相应的服务。特别是对于语音通知，你可以访问 https://www.apispace.com/chuanglan/api/253-notify-vocie/api/ 来获取详细信息并进行订阅。 API 接口分为两个主要部分： 1. 批量语音通知 批量语音通知适用于需要同时向多个电话号码发送相同语音消息的场景。以下是一个 PHP 调用示例： ```php <?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => "https://chuanglan.o.apispace.com/253-notify-vocie/batch-voice-notify", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "mobile=&templateId=&allowedCallTime=&billUrl=&transData=&playTimes=&isNotifyFileId=", CURLOPT_HTTPHEADER => array( "X-APISpace-Token:", "Authorization-Type:apikey", "Content-Type:application/x-www-form-urlencoded" ), )); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` 在这个示例中，你需要替换 `mobile`、`templateId` 等参数来指定接收者电话号码、模板ID（用于定制语音消息内容）和其他可选参数，如呼叫时间限制、账单地址、播放次数等。 2. 单个语音通知 如果只是需要向单个电话号码发送语音通知，可以使用单个语音通知 API。以下是 PHP 调用示例： ```php <?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => "https://chuanglan.o.apispace.com/253-notify-vocie/voice-notify", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "mobile=&templateId=&param=&allowedCallTime=&billUrl=&transData=&playTimes=&isNotifyFileId=", CURLOPT_HTTPHEADER => array( "X-APISpace-Token:", "Authorization-Type:apikey", "Content-Type:application/x-www-form-urlencoded" ), )); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` 这个示例与批量语音通知类似，但只针对单个电话号码。同样，确保填写正确的参数以符合你的需求。 在使用这些 API 时，需要注意以下几点： - `X-APISpace-Token` 和 `Authorization-Type:apikey` 都是必填的 HTTP 头部，用来验证 API 请求的合法性，需要从 APISpace 控制台获取。 - `Content-Type:application/x-www-form-urlencoded` 表明请求体的数据格式是 URL 编码的。 - `mobile` 参数是接收语音通知的电话号码，`templateId` 是预设的语音消息模板 ID，`param` 可以用来传递模板中需要的变量值。 - 其他参数如 `allowedCallTime`、`billUrl`、`transData`、`playTimes` 和 `isNotifyFileId` 是可选的，可以根据具体业务需求设置。 APISpace 提供的 API 文档会详细介绍每个参数的具体含义和使用方法，建议在实际开发中仔细查阅以确保正确使用。通过这些接口，开发者可以轻松集成语音通知功能到自己的应用程序中，提供更加人性化和高效的通知服务。