批量發送多內容簡訊

POST

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

批量發送多內容簡訊接口

請求參數

參數	說明	是否必填	類型
appId	應用ID	是	String
array	消息内容json集合	是	JSONArray
number	簡訊接收號碼，多個號碼之間以英文逗號分隔	是	String
content	發送內容，長度不能超過1024字元	是	String
senderId	發送號碼	否	String
orderId	自訂訊息id，orderId數量和手機號碼數量需保持一致	否	String

請求示例

Request URL:
    https://api.laaffic.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": "91856321412,91856321413",
            "content": "test message",
            "senderId": "",
            "orderId": "56584,56585"
        },
        {
            "numbers": "91856321414",
            "content": "test message1",
            "senderId": "",
            "orderId": "56586"
        }
    ]
}

響應參數

參數	說明	類型
status	狀態碼，0成功，其他失敗參見響應狀態碼說明	String
reason	失敗原因說明	String
success	提交成功的號碼個數	String
fail	提交失敗的號碼個數	String
array	提交成功的json集合	JSONArray
msgId	提交號碼對應平臺msgId	String
number	提交號碼	String
orderId	自定義消息id	String

注：提交發送短信成功後，系統會給每個提交成功的號碼對應生成一個平臺msgId，後續客戶可以根據這個msgId來査詢該號碼的發送結果。

響應狀態碼

status	狀態說明
0	成功
-1	認證錯誤
-2	Ip訪問受限
-3	短信內容含有敏感字元
-4	短信內容為空
-5	短信內容過長
-6	不是範本的簡訊
-7	號碼個數過多
-8	號碼為空
-9	號碼异常
-10	客戶餘額不足，不能滿足本次發送
-16	超出時間範圍限制
-18	端口程序异常
-19	聯絡商務傳簡訊報價

語言

Java

PHP

請求

package com.laaffic.api.demo.sms;

import cn.hutool.core.util.StrUtil;
import cn.hutool.crypto.SecureUtil;
import cn.hutool.http.Header;
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONUtil;

import java.net.URLEncoder;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

private void batchSendSms() {
    final String baseUrl = "https://api.laaffic.com/v3";
    final String apiKey = "your api key";
    final String apiPwd = "your api secret";
    final String appId = "your appid";

    Map map=new HashMap<>();
    map.put("numbers","91856321412,91856321413");
    map.put("content","hello world");
    final String url = baseUrl.concat("/sendSms/batch");

    HttpRequest request = HttpRequest.post(url);

    // currentTime
    final String datetime = String.valueOf(LocalDateTime.now().atZone(ZoneId.systemDefault()).toInstant().getEpochSecond());
    // generate md5 key
    final String sign = SecureUtil.md5(apiKey.concat(apiPwd).concat(datetime));

    request.header(Header.CONNECTION, "Keep-Alive")
    .header(Header.CONTENT_TYPE, "application/json;charset=UTF-8")
    .header("Sign", sign)
    .header("Timestamp", datetime)
    .header("Api-Key", apiKey);

    final String params = JSONUtil.createObj()
    .set("appId", appId)
    .set("array", Arrays.asList(map))
    .toString();

    HttpResponse response = request.body(params).execute();
    if (response.isOk()) {
        String result = response.body();
        System.out.println(result);
    }  
}

請求

header('content-type:text/html;charset=utf8');

$apiKey = "your api key";
$apiSecret = "your api secret";
$appId = "your appid";
$url = "https://api.laaffic.com/v3/sendSms/batch";
$timeStamp = time();
$sign = md5($apiKey.$apiSecret.$timeStamp);

$dataArr['appId'] = $appId;
$dataArr['array'] = array(
    array(
        'numbers' => '91856321412,91856321413',
        'content' => 'hello world',
    )
);

$data = json_encode($dataArr);
$headers = array('Content-Type:application/json;charset=UTF-8',"Sign:$sign","Timestamp:$timeStamp","Api-Key:$apiKey");

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 600);
curl_setopt($ch, CURLOPT_HTTPHEADER,$headers);
curl_setopt($ch, CURLOPT_POSTFIELDS , $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$output = curl_exec($ch);
curl_close($ch);
var_dump($output);

響應示例

{
  "status": "0",
  "reason": "success",
  "success": "2",
  "fail": "0",
  "array": [
      {
          "msgId": "2207201629421000001",
          "number": "91856321412",
          "orderId": "123"
      },
      {
          "msgId": "2207201629421000002",
          "number": "91856321413",
          "orderId": null
      }
  ]
}