闪送物流信息开放平台服务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