注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 阿里大于API

alibaba.aliqin.fc.tts.num.singlecall (文本转语音通知)

向指定手机号码发起单向呼叫,将文本模板内容转化为语音播放给被叫方。使用前需要在阿里大于管理中心添加去电显示号码与文本转语音模板。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
called_num String 必须 13700000000 被叫号码,支持国内手机号与固话号码,格式如下057188773344,13911112222,4001112222,95500
called_show_num String 必须 4001112222 被叫号显,传入的显示号码必须是阿里大于“管理中心-号码管理”中申请或购买的号码
tts_code String 必须 TTS_10001 TTS模板ID,传入的模板必须是在阿里大于“管理中心-语音TTS模板管理”中的可用模板
extend String 可选 12345 公共回传参数,在“消息返回”中会透传回该参数;举例:用户可以传入自己下级的会员ID,在消息返回时,该会员ID会包含在内,用户可以根据该会员ID识别是哪位会员使用了你的应用
tts_param Json 可选 {"AckNum":"123456"} 文本转语音(TTS)模板变量,传参规则{"key":"value"},key的名字须和TTS模板中的变量名一致,多个变量之间以逗号隔开,示例:{"name":"xiaoming","code":"1234"}

响应参数

名称 类型 示例值 描述
result BizResult 接口返回参数
  • └ model
  • String
  • 134523^4351232
  • 返回结果
  • └ msg
  • String
  • 成功
  • 返回信息描述
  • └ success
  • Boolean
  • false
  • true表示成功,false表示失败
  • └ err_code
  • String
  • 0
  • 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAliqinFcTtsNumSinglecallRequest req = new AlibabaAliqinFcTtsNumSinglecallRequest();
req.setCalledNum("13700000000");
req.setCalledShowNum("4001112222");
req.setTtsCode("TTS_10001");
req.setExtend("12345");
req.setTtsParamString("{\"AckNum\":\"123456\"}");
AlibabaAliqinFcTtsNumSinglecallResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_aliqin_fc_tts_num_singlecall_response>
    <result>
        <model>134523^4351232</model>
        <msg>成功</msg>
        <success>false</success>
        <err_code>0</err_code>
    </result>
</alibaba_aliqin_fc_tts_num_singlecall_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.OUT_OF_SERVICE 业务停机 请登录阿里大鱼充值
isv.PRODUCT_UNSUBSCRIBE 未开通产品服务 请登录阿里大鱼开通相应产品服务
isv.ACCOUNT_NOT_EXISTS 账户信息不存在 请登录阿里大鱼完成入驻
isv.ACCOUNT_ABNORMAL 账户信息异常 请联系技术支持
isv.MOBILE_NUMBER_ILLEGAL 手机号码格式不合法 请使用合法的手机号码
isv.TTS_TEMPLATE_ILLEGAL 文本转语音模板不合法 请使用合法的文本转语音模板。登录www.alidayu.com查看已审核通过的文本转语音模板。
isv.DISPLAY_NUMBER_ILLEGAL 号显不合法 请使用合法的号显。登录www.alidayu.com查询已审核通过的号码
isv.TEMPLATE_MISSING_PARAMETERS 文本转语音模板参数缺失 登录www.alidayu.com查询文本转语音模板,检查模板参数是否漏传。
isv.INVALID_PARAMETERS 参数异常 请检查入参是否合法
isv.60004 - -
isv.BLACK_KEY_CONTROL_LIMIT 模板变量中存在黑名单关键字。如:阿里大鱼 黑名单关键字禁止在模板变量中使用,若业务确实需要使用,建议将关键字放到模板中,进行审核。
isv.PARAM_NOT_SUPPORT_URL 变量不支持url参数 变量不支持url参数
isv.BUSINESS_LIMIT_CONTROL 触发业务流控 触发业务流控
isv.PARAM_LENGTH_LIMIT 参数长度受限 调整模板变量参数长度
isp.SYSTEM_ERROR 系统错误 系统错误

API工具

如何获得此API

FAQ

返回
顶部