首页 帮助中心 API

批量发送多内容短信

说明: 批量发送多内容短信接口

请求参数说明:

参数 说明 是否必填 类型

appId

应用id(短信-短信应用)

String

array

消息内容json集合

Array

  numbers

短信接收号码,多个号码之间以英文逗号分隔

String

  content

发送内容,长度不能超过1024字符

String

  senderId

发送号码,最大长度是32个字符

String

  orderId

自定义消息id,orderId 数量和手机号码数量需保持一致

String

请求URL:

                      
                        https://api.onbuka.com/v3/sendSms/batch
                      
                    

请求示例:

                      
                        Request URL:
                            https://api.onbuka.com/v3/sendSms/batch
                        Request Method:
                            POST
                        Request Headers:
                            Content-Type: application/json;charset=UTF-8
                            Sign: 05d7a50893e22a5c4bb3216ae3396c7c
                            Timestamp: 1630468800
                            Api-Key: bDqJFiq9
                        Request Body:
                        {
                          "appId": "4luaKsL2",
                          "array": [
                            {
                              "numbers": "86156584848,86156584848",
                              "content": "test message",
                              "senderId": "",
                              "orderId": "56584,56585"
                            },
                            {
                              "numbers": "86156584848,86156584848",
                              "content": "test message1",
                              "senderId": "",
                              "orderId": "56586,56587"
                            }
                          ]
                        }
                      

                    

响应参数说明:

参数 说明 类型

status

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

String

reason

失败原因说明

String

success

提交成功的号码个数

String

fail

提交失败的号码个数

String

array

提交成功的json集合

JSONArray

  msgId

提交号码对应平台msgId

String

  number

提交号码

String

  orderId

自定义消息id

String

注:提交发送短信成功后,系统会给每个提交成功的号码对应生成一个平台msgId,后续客户可以根据这个msgId来查询该号码的发送结果。

响应示例:

                     
                        {
                            "status": "0",
                            "reason": "success",
                            "success": "4",
                            "fail": "0",
                            "array": [
                                {
                                    "msgId": "2207201629421000001",
                                    "number": "86156584848",
                                    "orderId": "56584"
                                },
                                {
                                    "msgId": "2207201629421000002",
                                    "number": "86156584848",
                                    "orderId": "56585"
                                },
                                {
                                    "msgId": "2207201629431000003",
                                    "number": "86156584848",
                                    "orderId": "56586"
                                },
                                {
                                    "msgId": "2207201629431000004",
                                    "number": "86156584848",
                                    "orderId": "56587"
                                }
                            ]
                        }
                    

                  
 

意见反馈

0/500