首页 文章 精选 留言 我的

精选列表

搜索[精准预约],共10000篇文章
优秀的个人博客,低调大师

国际语音精准营销接口如何接入?

## 一、文档基础信息 - 参考融合源:国内语音通知接口、国际短信接口文档 - 编码规范:统一使用 UTF-8 - 请求方式:GET / POST 均支持,7×24小时全天候提交 ## 二、接口描述 本接口用于发送国际/港澳台语音通知呼叫,支持国际手机、境外固话外呼; 鉴权支持两种模式:固定APIKEY鉴权、动态MD5密码鉴权; 单次仅支持提交单个境外号码呼叫; 响应同时返回 JSON / XML 两种格式,自动适配请求接收类型。 ## 三、请求头说明 | 参数名称 | 参数固定值 | 类型 | 必填 | | ---- | ---- | ---- | ---- | | Content-Type | application/x-www-form-urlencoded | string | 是 | ## 四、请求参数说明 | 参数名称 | 参数说明 | 示例 | 类型 | 必填 | | ---- | ---- | ---- | ---- | ---- | | account | APIID获取路径:用户中心【云语音】-【国际语音通知】-【产品总览】 | 12345678 | string | 是 | | password | 鉴权密码二选一:1. 固定鉴权:APIKEY(产品总览查看)2. 动态鉴权:MD5加密动态密码(文末提供加密代码) | abcdef123456 | string | 是 | | mobile | 国际接收号码,单次仅传1个;格式规范:国家区号+空格+手机号港澳台/国际固话同理:区号空格号码 | 1 978234523852 61234567 | string | 是 | | content | 语音播报内容,两种使用模式:1. 完整播报模式:直接填写完整播报文本2. 模板变量模式:多变量使用英文竖线 `\|` 分隔 | 您的国际订单已发货,运单号HK20260731HK20260731\|顺丰国际\|180美元 | string | 否 | | templateid | 国际语音模板ID,使用模板变量播报时必填调试测试模板ID:2361默认测试模板内容:您的国际订单号:【变量】,承运商:【变量】,金额:【变量】,请注意接听 | 2361 | int | 否 | | time | 10位Unix时间戳仅使用**动态密码鉴权**时必填 | 1754064000 | string | 动态鉴权必填 | ## 五、响应返回参数 | 参数名称 | 参数说明 | 成功示例 | 类型 | 是否必返回 | | ---- | ---- | ---- | ---- | ---- | | code | 业务状态码,2=提交成功 | 2 / 1 | int | 是 | | msg | 提交结果文字描述 | 提交成功 / 手机号格式错误 | string | 是 | | ivmid | 语音呼叫唯一流水号;失败返回0或空字符串 | 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 | 提交失败 | 接口服务内部异常,稍后重试 | ## 七、GET 请求完整调用示例 ### 完整文本播报模式 ``` https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=abcdef123456&mobile=1 978234523&content=您的国际订单已发货,运单号HK20260731 ``` ### 模板变量模式 ``` https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=abcdef123456&mobile=852 61234567&templateid=2361&content=HK20260731|顺丰国际|180美元 ``` ### 动态密码鉴权模式(带time时间戳) ``` https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=md5加密后字符串&mobile=1 978234523&templateid=2361&content=HK20260731|顺丰国际|180美元&time=1754064000 ``` ## 八、接口返回响应示例 ### 1. 成功返回 JSON ```json { "code": 2, "msg": "提交成功", "ivmid": "17540640009876" } ``` ### 2. 成功返回 XML ```xml 2 提交成功 17540640009876 ``` ### 3. 失败返回 JSON ```json { "code": 406, "msg": "手机格式不正确" } ``` ### 4. 失败返回 XML ```xml 406 手机格式不正确 ``` ## 九、PHP 动态密码 MD5 加密代码示例 动态密码加密规则:`md5(account + 原始APIKEY + mobile + content + time)` 所有拼接内容必须统一 UTF-8 编码后加密 ```php ``` ## 十、多语言代码示例支持 接口同时提供多语言接入示例,覆盖主流开发语言: - Java - PHP - Python - C - C++ - C# - Go - Shell - Ruby - Node.js - Objective-C

资源下载

更多资源
Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

腾讯云软件源

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题,腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构,目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Rocky Linux

Rocky Linux

Rocky Linux(中文名:洛基)是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版,作为CentOS稳定版停止维护后与RHEL(Red Hat Enterprise Linux)完全兼容的开源替代方案,由社区拥有并管理,支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性,采用模块化包装和SELinux安全架构,默认包含GNOME桌面环境及XFS文件系统,支持十年生命周期更新。

用户登录
用户注册