注册或者登录开发者账号流程说明请参考登录注册>>
创建应用及申请上线流程说明请参考创建应用及申请上线>>
资质认证流程说明可参考账号认证>>
点击“应用管理”→“语音库管理” →“语音通知”中的“添加语音”。
如下所示:
注:
语音通知铃声,每个应用下可上传多个语音。 语音的格式必须是wav或mp3(不支持直接改后缀名),文件大小不能超过1M。
URL格式
https://api.ucpaas.com/{SoftVersion}/
URL参数属性说明
属性 | ||
---|---|---|
SoftVersion | 云之讯REST API版本号,当前版本号为:2014-06-30 | |
Account | 此参数为默认固定值 | |
accountSid | 注册云之讯官网,在控制台中即可获取此参数 | |
function | 业务功能 | |
operation | 业务操作,业务功能的各类具体操作分支 | |
SigParameter | 请求URL必须带有此参数 |
HTTP标准包头字段(必填)
属性 | 说明 | |
---|---|---|
Accept | 客户端响应接收数据格式:application/xml、application/json | |
Content-Type | 类型:application/xml;charset=utf-8、application/json;charset=utf-8 | |
Authorization | 验证信息 | |
Content-Length | 包体长度 |
接口文档连接请参见附录
toSerNum:
企业认证用户才支持显号功能。未开启显号功能则呼叫会随机显号,设置此参数无效。
type:
0-文本(接口调用成功后,文本内容需人工审核,审核通过后合成语音进行外呼,及时性比较低)
1-语音id (先在管理中心上传语音文件,语音文件需进行人工审核,审核通过后用户可以直接调用接口传入语音ID进行外呼,无须再次审核,及时性比较高,适用于内容相同情况)
JSON 请求示例
JSON 请求示例
POST/2014-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/Calls/voiceNotify? sig=4D3C2549D3A487841CB3D84EA7421FCD Host:api.ucpaas.com Accept:application/json Content-Type:application/json;charset=utf-8 Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxODQ3MzQ= { "voiceNotify" : { "appId" : "e462aba25bc6498fa5ada7eefe1401b7", "to" : "18612345678", "type" : "0", “content” : “您好,您有一个通知!", "toSerNum" : "075512345678", "playTimes" : "3“ } }
JSON 响应示例
JSON 响应示例
{"resp":{ "respCode":"000000", "voiceNotify" : { "callId" : "31d7ca243c406a81611910db21b68876", "createDate" : 20140623184729 } } } }
XML请求示例
XML请求示例
POST/2014-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/Calls/voiceNotify.xml? sig=841D35E63BB81C1D13918B4DD6CD988E Host:api.ucpaas.com Accept:application/xml Content-Type:application/xml;charset=utf-8 Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxODQ1MjM= <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <voiceNotify> <appId>e462aba25bc6498fa5ada7eefe1401b7</appId> <to>18612345678</to> <type>0</type> <content>您好,您有一条消息。</content> <toSerNum>075512345678</toSerNum> <playTimes>3</playTimes> </voiceNotify>
XML 响应示例
XML 响应示例
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <resp> <respCode>000000</respCode> <voiceNotify> <callId>48dcc7d44fb274f316924bedd7696645</callId> <createDate>20140623184518</createDate> </voiceNotify> </resp>
http://localhost/doku.php?id=rest_error
2.调用接口返回100699 系统内部错误
a.查看接口参数sig是否拼写正确 sig= md5(账户Id + 账户授权令牌 + 时间戳)共32位, md5加密后转大写 b.查看接口参数Authorization是否拼写正确 Authorization=base64(账户Id +冒号+ 时间戳) 时间戳是当前系统时间(24小时制) yyyyMMddHHmmss
3.调用接口返回100005 访问ip不合法
创建应用时,基础配置中的服务器白名单清空下,如果配置了服务器白名单调用接口 必须在白名单上调用,否则就会报此错。
4.企业用户如何显示400号码
应用管理-应用列表-找到对应的应用-管理-号码管理 添加需要显示的400号码,400号码审核需要提供资料:3证信息(营业执照、组织机构代码证、税务登记证)+400开户合同+400授权书(云之讯提供,须加盖公司公章)发送到fangyundan@ucpaas.com