首页 帮助中心 API

发送文件语音消息

说明: 通过已上传的语音文件id,发起文件语音消息。

请求参数说明:

参数 说明 是否必填 类型

callee

被叫号码,最大500个手机号,多个手机号以逗号隔开,每个手机号为:国码+手机号组成的7-15位数字。

String

displayNum

显示号码,7-15位数字,允许为空

String

fileId

已上传语音文件id

String

appId

语音应用id

String

maxDuration

最长通话时长,接通后N秒强制挂断,1-120数字,允许为空。

Int

maxRingingTime

最大响铃时长,默认60,可输入20-120秒。

Int

calledInfo

被叫信息,0-1000位字符

String

loopCount

循环播报次数,1-9数字,默认为1,允许为空。

Int

请求URL:

                    
                      https://api.onbuka.com/v3/voice/sendGroup
                    
                  

请求示例:

                    
                      RequestURL:
                        https://api.onbuka.com/v3/voice/sendGroup
                      RequestMethod:
                        POST
                      RequestHeaders:
                        Content-Type: application/json;charset=UTF-8
                        Sign: 05d7a50893e22a5c4bb3216ae3396c7c
                        Timestamp: 1630468800
                        Api-Key: bDqJFiq9
                      RequestBody:
                        {
                          "callee": "932111111111,932111111112",
                          "displayNum": "1008122211",
                          "fileId": "12022022570cc2484c59d4f8b9745d34226285b1e.mp3",
                          "appId": "4luaKsL2",
                          "maxDuration": 50,
                          "maxRingingTime":60,
                          "loopCount": 2,
                          "calledInfo":"calledInfo"
                        }
                    
                  

响应参数说明:

参数 说明 类型

status

状态码,0成功,其他失败参见状态码说明

String

reason

失败原因说明

String

data

提交结果集合

JSONArray

voiceId

记录唯一id

String

callee

被叫号码

String

terminationCode

状态码0成功其他失败

String

terminationReason

状态码描述

String

响应示例:

                    
                      {
                        "status": "0",
                        "reason": "success",
                        "data": [
                          {
                            "voiceId": "2203031134011000001",
                            "callee": "932111111111",
                            "terminationCode": "0",
                            "terminationReason": "success"
                          },
                          {
                            "voiceId": "2203031134011000002",
                            "callee": "932111111112",
                            "terminationCode": "0",
                            "terminationReason": "success"
                          }
                        ]
                      }
                    
                  
 

意见反馈

0/500