语音通知

第三方服务商
价格:¥0.01元起  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

原本以短信的方式通知变成打电话的方式通知对方,将通知变得更实时和高效。杜绝漏看和无法接收通知的问题

1.创建模板


接口地址:http://route.showapi.com/1441-2 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。 
文件上传的POST时,enctype=multipart/form-data。 

1、系统级参数(所有接入点都需要的参数): 

参数名称类型示例值必须描述
showapi_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 

参数名称类型默认值示例值必须描述
contentString 尊敬的[userName],您好!您的快递单号[mailNo]正在派送中,请注意签收!语音通知的模板内容,内容要求是100个字符以内.
notiPhoneString 13866..668模板创建的联系人,模板审核成功后,会以此电话进行短信通知!
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1441-2","my_appId","my_appSecret") .addTextPara("content","尊敬的[userName],您好!您的快递单号[mailNo]正在派送中,请注意签收!") .addTextPara("notiPhone","13866..668") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起 

名称类型示例值描述
showapi_res_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口 
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
 
showapi_res_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起 

名称类型示例值描述
ret_code String0接口操作是否成功,0表示成功,其他值为失败
remark String提交成功,请等待管理员审核!联系电话:0871-67410244 qq:2802673087操作说明
tNum StringT170717001056模板编号
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": "0", "remark": "提交成功,请等待管理员审核!联系电话:0871-67410244 qq:2802673087", "tNum": "T170717001056" } }

2.模板查询


接口地址:http://route.showapi.com/1441-1 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1441-1","my_appId","my_appSecret") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
tNum String
T170717001056
模板编号
content String
尊敬的[userName],您好!您的快递单号[mailNo]正在派送中,请注意签收!
模板内容
status String
0
模板状态,0待审核 1审核通过 -2是审核失败 2删除
notiPhone String
模板创建的联系人
ct String
2017-07-19 11:18:05
模板创建的时间
remark String
待审核
模板状态的提示信息
ret_code String
0
0表示操作成功,其他表示失败
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": "0", "templates": [ { "content": "尊敬的[userName],您好!您的快递单号[mailNo]正在派送中,请注意签收!", "status": "0", "remark": "待审核", "tNum": "T170717001056", "ct": "2017-07-19 11:18:05", "notiPhone": "" } ], "remark": "查询成功!" } }

3.发送语音通知


接口地址:http://route.showapi.com/1441-3 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
mobile String
13888..668
接收语音通知的电话号码
tNum String
T170717...
模板编号,创建模板时返回的tNum,注意只有审核通过的模板才可以发通知
content String
{"userName":"张三疯","mailNo":"610349360550"}
替换参数用的json字符串,传递参数时,注意是否需要urlencode
sex String
1
语音通知的声音 1男士声音 2女士声音
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1441-3","my_appId","my_appSecret") .addTextPara("mobile","13888..668") .addTextPara("tNum","T170717...") .addTextPara("content","{\"userName\":\"张三疯\",\"mailNo\":\"610349360550\"}") .addTextPara("sex","1") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code String
0
0表示业务操作成功,其他为失败
taskID String
1707182303241370002
发送请求的流水--任务id
remark String
提交成功!
操作提示
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": "0", "taskID": "1707182303241370002", "remark": "提交成功!", "successCounts": "1" } }

发送定时语音


接口地址:http://route.showapi.com/1441-4 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
mobile String
13888..660
接收语音通知的手机号码
tNum String
T170718....
模板编号,创建模板的时候的tNum
sendTime String
20170719091000
定时发送的时间,要求1小时以后,15天以内,时间格式:yyyyMMddHHmmss
content String
{"userName":"张三疯","mailNo":"610349360550"}
需要替换的参数,json字符串,需要注意该信息时是否需要手动进行urlencode
sex String
1
性别 1男士声音 2女士声音
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1441-4","my_appId","my_appSecret") .addTextPara("mobile","13888..660") .addTextPara("tNum","T170718....") .addTextPara("sendTime","20170719091000") .addTextPara("content","{\"userName\":\"张三疯\",\"mailNo\":\"610349360550\"}") .addTextPara("sex","1") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code String
0
业务状态码,0表示成功,其他为失败
remark String
提交成功!
提示信息
taskID String
1707182303241370005
请求的流水
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": "0", "remark": "提交成功!", "taskID": " 1707182303241370005" } }

4.查询发送记录


接口地址:http://route.showapi.com/1441-5 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
taskID String
每次请求的流水
mobile String
133888...8
接收语音通知的电话号码
start String
2017-07-01 10:30:00
短信提交的时间段的起始时间,时间格式:yyyy-HH-MM HH:mm:ss
end String
2017-07-15 90:00:00
短信提交的时间段的截止时间,时间格式:yyyy-HH-MM HH:mm:ss
tNum String
T1707....
模板编号
page String
分页查询数据,默认1为当前页,每页返回20条数据
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1441-5","my_appId","my_appSecret") .addTextPara("taskID","") .addTextPara("mobile","133888...8") .addTextPara("start","2017-07-01 10:30:00") .addTextPara("end","2017-07-15 90:00:00") .addTextPara("tNum","T1707....") .addTextPara("page","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
content String
发送的文字内容
successCounts String
发送成功的条数
remark String
备注信息
sendStatus String
通知发送的状态 0为待发送,10发送成功,20发送失败
receiveTime String
接收通知的时间
taskID String
请求流水
ct String
语音通知提交的时间
sendMethod String
发送的方式: voiceNotice普通语音通知 ,voiceNoticeTime 定时通知
mobile String
接收语音通知的电话号码
ret_code String
操作标识,0标识成功,其他值为失败
allNum String
所有发送的记录条数
allPages String
所有页数
currentPage String
当前页数
maxResult String
每页最大的数据量,默认20
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "datas": [ { "content": "尊敬的李逵,您好!您的快递单号610349360550正在派送中,请注意签收!", "successCounts": "1", "remark": "发送失败!", "receiveTime": "", "sendStatus": "20", "sendMethod": "voiceNotice", "ct": "2017-07-19 11:35:58", "taskID": "1707191135588050001", "mobile": "13388842309" }, { "content": "尊敬的张三疯,您好!您的快递单号610349360550正在派送中,请注意签收!", "successCounts": "1", "remark": "发送成功!", "receiveTime": "", "sendStatus": "10", "sendMethod": "voiceNotice", "ct": "2017-07-19 15:42:00", "taskID": "1707191542005730001", "mobile": "13330447002" }, { "content": "您的快递单号对应公司查询服务异常,请尽快处理!", "successCounts": "1", "remark": "发送失败!", "receiveTime": "", "sendStatus": "20", "sendMethod": "voiceNotice", "ct": "2017-09-20 19:45:02", "taskID": "1709201945021360001", "mobile": "13388842309" } ], "allPages": 1, "ret_code": "0", "remark": "查询成功!", "currentPage": 1, "allNum": 4, "maxResult": 20 } }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种API操纵资源。

截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。

 

联系方式:

电话: 4009988033

 

微博: http://www.weibo.com/showapi

 

邮箱: services@showapi.com

 

QQ: 3007663665

 

微信: show_api

进制数据介绍:

企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。

 

 

联系我们:

电话:173-6457-5198

QQ① 群:792473404

客服 QQ:1643296538

微信客服:binstds

                                      扫描二维码添加客服微信

 

 

工作时间

 周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00) 

周六 9:00 - 12:00(节假日除外) 

 

 

进制数据团队

 

 

2020.01.01

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐