## 一、接口能力说明

- 支持阿尔及利亚手机、固定电话语音外呼；

- 两种播报模式：直接提交文本播报、模板 ID + 变量播报；

- 鉴权二选一：固定 APIKEY、动态 MD5 加密密码（推荐生产环境使用，防重放）；

- 限制：单次仅提交 1 个号码，自带号码频次风控；

- 返回自动识别 JSON/XML，方便不同项目接入。

## 二、请求头


|参数名称|参数固定值|类型|必填|
|:-:|:-:|:-:|:-:|
|Content-Type|application/x-www-form-urlencoded|string|是|
## 三、请求参数


|参数名称|参数说明|示例|类型|必填|
|:-:|:-:|:-:|:-:|:-:|
|account|APIID，用户中心【云语音】-【国际语音通知】产品总览获取|12345678|string|是|||
|password|鉴权密码二选一：固定 APIKEY / MD5 动态密码|abcdef123456|string|是|||
|mobile|阿尔及利亚号码，格式：213 + 空格 + 号码|213 551234567|string|是|||
|content|播报文本；模板模式用英文竖线 `|` 分隔多个变量|您的验证码是 6294，5 分钟有效6294|5 分钟|string|否|
|templateid|模板变量播报时必填，测试模板 ID：2361|2361|int|否|||
|time|10 位 Unix 时间戳，仅动态 MD5 鉴权必填|1754064000|string|动态鉴权必填|||
>测试模板 2361 文案：您的海外订单号：【变量】，承运商：【变量】，金额：【变量】，请注意接听，可修改用于验证码场景报备。

## 四、返回参数


|参数名称|参数说明|成功示例|类型|是否必返回|
|:-:|:-:|:-:|:-:|:-:|
|code|业务码，2 代表提交成功|2|int|是|
|msg|结果描述|提交成功|string|是|
|ivmid|呼叫唯一流水号，成功才有，用于查询呼叫状态|17540640009876|string|提交成功返回|
## 五、状态码排查表


|code|msg提示|问题说明|
|:-:|:-:|:-:|
|0|提交失败|通用未知提交异常|
|2|提交成功|呼叫任务已受理排队|
|400|非法 ip 访问|服务器出口 IP 未备案 / 未添加白名单|
|401|帐号不能为空|account 参数缺失|
|402|密码不能为空|password 参数缺失|
|403|手机号码不能为空|mobile 参数为空|
|4030|手机号码已被列入黑名单|该境外号码限制外呼|
|404|语音内容不能为空|未传 content 且未传合法 templateid|
|405|用户名或密码不正确|account/APIKEY 不匹配|
|4050|账号被冻结|账户欠费 / 违规冻结，联系客服|
|40505|没有签定合同|未开通国际语音业务权限|
|4051|剩余条数不足|国际语音余额不足|
|4052|访问 ip 与备案 ip 不符|服务器出口 IP 和后台备案不一致|
|406|手机格式不正确|境外号码缺少国家区号、格式不规范|
|407|语音内容含有敏感字符|播报文本包含违规敏感词|
|4071|没有提交备案模板|使用 templateid 但模板未报备审核|
|4072|提交的语音内容必须与报备过的模板格式相匹配|传入变量数量与备案模板变量数量不一致|
|40722|变量内容超过指定的长度|单个变量文本超出模板限制字数|
|4077|播报内容未在运营商报备|完整文本播报模式未提前报备文案|
|408|您的帐户疑被恶意利用，已被自动冻结，如有疑问请与客服联系。|风控检测异常自动冻结账号|
|4080|同一手机号码同一秒钟之内发送频率不能超过 1 条|单号码每秒呼叫上限 1 次|
|4081|同一手机号一分钟之内发送超过 3 条|单号码每分钟呼叫上限 3 次|
|4082|超出同一手机号一天之内 10 条语音限制|单号码单日最大呼叫 10 次|
|4086|提交失败|接口服务内部异常，稍后重试|
## 六、调用示例（阿尔及利亚注册验证场景）

### 1、固定密码鉴权 GET（直传文本播报）

```
https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=abcdef123456&mobile=213 551234567&content=您的注册验证码为6294，5分钟内有效
```### 2、模板变量模式 GET

```


```
https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=md5加密字符串&mobile=213 551234567&templateid=2361&content=6294|5分钟&time=1754064000
```## 七、返回示例

✅ JSON 成功
```
{
  "code": 2,
  "msg": "提交成功",
  "ivmid": "17540640009876"
}
```✅ XML 成功
```
<?xml version="1.0" encoding="utf-8"?>
<SubmitResult>
  <code>2</code>
  <msg>提交成功</msg>
  <ivmid>17540640009876</ivmid>
</SubmitResult>
```❌ JSON 失败示例
```
{
  "code": 406,
  "msg": "手机格式不正确"
}
```## 八、PHP 动态 MD5 加密代码（UTF-8）

加密规则：`md5(account + 原始APIKEY + mobile + content + time)`，全部 UTF-8 拼接后加密
```
<?php
$account = '12345678';
$apikey = 'abcdef123456';
$mobile = '213 551234567';
$content = '6294|5分钟';
$time = '1754064000';
$originStr = $account . $apikey . $mobile . $content . $time;
$password = md5($originStr);
?>
```## 九、支持开发语言列表

Java、PHP、Python、C、C++、C#、Go、Shell、Ruby、Node.js、Objective-C
## 十、对接注意事项（注册验证场景重点）

1. 阿尔及利亚号码务必是 `213 号码` 格式，区号和号码中间带空格，否则 406 报错；

2. 用于验证码播报的文本或者模板，必须提前提交报备审核，否则返回 4077、4071；

3. 风控限制：单号码每秒≤1 次、每分钟≤3 次、每日≤10 次呼叫，注册验证业务做好限流和重试机制；

4. 生产环境优先使用动态 MD5 鉴权，防止链接被抓包重放刷呼叫；

5. 接口提交成功（code=2）仅代表任务入队，不代表用户已经接听；如需呼叫结果，可搭配回执接口。

鉴权二选一：固定 APIKEY、动态 MD5 加密密码（推荐生产环境使用，防重放）；

阿尔及利亚语音通知接口怎么对接？账户注册语音验证

阿尔及利亚语音通知接口是国际语音通知服务下的外呼接口，专门面向阿尔及利亚手机号、固话发起语音呼叫，广泛用于海外平台账户注册语音验证、登录二次核验、密码找回、订单通知等场景。开发者对接时支持固定 APIKEY 鉴权、动态 MD5 鉴权两种安全方案，单次提交单个号码，接口同时兼容 JSON、XML 返回格式，7×24 小时稳定提交呼叫任务。阿尔及利亚区号为**213**，号码格式要求：`213 手机号

编程语言

阿尔及利亚国际语音外呼接口支持文本与模板播报，提供固定APIKEY及动态MD5双鉴权模式，覆盖手机及固定电话。单次呼叫单号码，具备秒级频次风控。返回JSON/XML格式，含完整状态码排查表，适配多语言开发，适用于注册验证码等高安全场景。

代码解释

Objective-C

服务器

验证码

Python

Java

JSON

Unix

让每一个 Agent，都跑在云上

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

阿尔及利亚语音通知接口怎么对接？账户注册语音验证-腾讯云开发者社区-腾讯云

阿尔及利亚语音通知接口怎么对接？账户注册语音验证

阿尔及利亚语音通知接口怎么对接？账户注册语音验证

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐