閃送物流信息開放平臺服務API使用指南

1. 調用流程概述

合作方調用配送開放平臺API的基本流程如下：

1. 填充參數：準備請求所需的系統參數和業務參數。
2. 生成簽名：根據參數生成請求的簽名。
3. 拼裝HTTP請求：構建HTTP請求，包括請求URL和請求體。
4. 發起HTTP請求：發送請求到指定的API地址。
5. 得到HTTP響應：接收并處理API的響應。
6. 解析響應數據：解析返回的JSON格式數據。

2. 環境設置

• 測試環境請求地址：http://open.s.bingex.com
• 生產環境請求地址：https://open.ishansong.com
• 傳輸協議：HTTP
• 請求方式：POST

3. 簽名生成步驟

1. 參數排序：將所有參數按字典順序排序，排除值為空的字段及sign字段。
2. 拼接字符串：根據以下格式拼接參數：

App_secret + accessToken + accessToken的值 + clientId + App ID的值 + data + data的值 + timestamp + timestamp的值

3. MD5加密：對拼接好的字符串進行MD5加密，得到32位大寫簽名值。

4. 示例代碼

以下是使用Java進行API請求的示例代碼：

4.1 引入必要的類

import org.apache.http.client.methods.HttpPost;
import java.util.HashMap;
import java.util.Map;

4.2 簽名計算函數

public static String calculateSign(String appSecret, String accessToken, String clientId, String data, Long timestamp) {
    StringBuilder sb = new StringBuilder(appSecret)
        .append("accessToken").append(accessToken)
        .append("clientId").append(clientId)
        .append("data").append(data)
        .append("timestamp").append(timestamp);
    
    return bytesToMD5(sb.toString().getBytes());
}

4.3 發送POST請求的函數

public static String sendPost(String url, Map<String, Object> params) {
    // 實現HTTP POST請求的邏輯
}

4.4 主方法示例

public static void main(String[] args) {
    String appSecret = "your_app_secret";
    String accessToken = "your_access_token"; // 如果有
    String clientId = "your_client_id";
    String data = "{\"key\":\"value\"}"; // 根據具體業務接口設置
    Long timestamp = System.currentTimeMillis();
    
    String sign = calculateSign(appSecret, accessToken, clientId, data, timestamp);
    
    Map<String, Object> params = new HashMap<>();
    params.put("clientId", clientId);
    if (accessToken != null) params.put("accessToken", accessToken);
    if (data != null) params.put("data", data);
    params.put("timestamp", timestamp);
    params.put("sign", sign);
    
    String response = sendPost("http://open.s.bingex.com/openapi/your_api_endpoint", params);
    // 處理響應
}

5. 注意事項

• 確保所有請求參數均按要求填充。
• 簽名生成需確保參數順序和拼接格式正確。
• 處理響應時需檢查狀態碼，確保請求成功。

通過以上步驟和示例代碼，用戶可以方便地對接和集成服務API。

詳情查看鏈接：https://open.ishansong.com/documentCenter/326