PB狀態報告回呼說明

POST

https://api.laaffic.com/v3/postback/backfill

簡訊狀態報告回檔

請求參數

appId

String

必填

應用id

msgid

String

平臺的消息id

number

String

必填

帶有號碼前綴的客戶手機號碼，例如：8613512345678

time

String

必填

驗證碼回填的時間戳

請求示例

Request URL:
  https://api.laaffic.com/v3/postback/backfill
Request Method:
  POST
Request Headers:
  Content-Type:application/json;charset=UTF-8
  Sign:05d7a50893e22a5c4bb3216ae3396c7c
  Timestamp:1630468800
  Api-Key:bDqJFiq9
Request Body:
{
  "appId":"4luaKsL2",
  "msgid":"2304101710409000001",
  "number":"91856321412",
  "time":"1681184764000"
}

響應參數

參數	説明	類型
status	狀態碼，0表示成功，其他均爲失敗，詳見狀態碼説明.	String
reason	失敗原因説明	String

語言

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 pbReportBackFill() {
    final String baseUrl = "https://api.laaffic.com/v3";
    final String apiKey = "your api key";
    final String apiPwd = "your api secret";
    
    final String appId = "{{appId}}";
    final String msgid = "{{msgid}}";
    final String number = "{{number}}";
    final String time = "{{time}}";
    
    final String url = baseUrl.concat("/postback/backfill");
    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.CONTENT_TYPE, "application/json;charset=UTF-8")
        .header("Sign", sign)
        .header("Timestamp", datetime)
        .header("Api-Key", apiKey);
    
    final String body = JSONUtil.createObj()
        .set("appId",appId)
        .set("msgid", msgid)
        .set("number", number)
        .set("time", time)
        .toString();
    
    HttpResponse response = request.body(body).execute();
    if (response.isOk()) {
        String result = response.body();
        System.out.println(result);
    }
}

REQUEST

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

$apiKey = "your api key";
$apiSecret = "your api secret";
$appId = "{{appId}}";
$url = "https://api.laaffic.com/v3/postback/backfill";
$timeStamp = time();
$sign = md5($apiKey.$apiSecret.$timeStamp);

$dataArr['appId'] = $appId;
$dataArr['msgid'] = "{{msgid}}";
$dataArr['number'] = "{{number}}";
$dataArr['time'] = "{{time}}";

$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"
}