Agiso Alds API Guide

https://open.agiso.com/document/#/alds
Admin
This project provides a development guide for integrating with the Agiso Alds platform, detailing...
Tokens:2,679
Snippets:7
Trust Score:8.2
Update:4 months ago
Show doc for...
Tokens:
Raw
### Python: Simulate Logistics Dummy Send API Call

Source: https://open.agiso.com/document/#/alds/guide

This Python class provides a client for the Agiso API, specifically for the LogisticsDummySend endpoint. It handles parameter preparation, signature generation using MD5, and sending POST requests. Remember to replace placeholder credentials with your actual `app_secret` and `access_token`.

```python
import hashlib
import time
import requests
from urllib.parse import urlencode

class AgisoApiClient:
    def __init__(self, app_secret, access_token):
        self.app_secret = app_secret
        self.access_token = access_token
        self.api_url = "https://gw-api.agiso.com/alds/Trade/LogisticsDummySend"

    def logistics_dummy_send(self, tids):
        """模拟发货接口调用"""
        # 1. 准备基础参数
        params = {
            "tids": tids,
            "timestamp": str(int(time.time()))  # 当前时间戳（秒级）
        }

        # 2. 生成签名
        try:
            params["sign"] = self._generate_sign(params)
        except Exception as e:
            print(f"生成签名失败: {e}")
            return None

        # 3. 设置请求头
        headers = {
            "Authorization": f"Bearer {self.access_token}",
            "ApiVersion": "1",
            "Content-Type": "application/x-www-form-urlencoded"
        }

        # 4. 发送POST请求
        try:
            response = requests.post(
                self.api_url,
                data=urlencode(params),  # 表单编码
                headers=headers
            )
            if response.status_code == 200:
                return response.text
            else:
                return f"Error Response: {response.status_code} - {response.text}"
        except Exception as e:
            print(f"请求发送失败: {e}")
            return None

    def _generate_sign(self, params):
        """生成MD5签名"""
        # 1. 参数按键名排序
        sorted_params = sorted(params.items(), key=lambda x: x[0])

        # 2. 拼接签名字符串
        query_str = self.app_secret
        for key, value in sorted_params:
            query_str += f"{key}{value}"
        query_str += self.app_secret

        # 3. 计算MD5并转为小写十六进制
        md5 = hashlib.md5()
        md5.update(query_str.encode('utf-8'))
        return md5.hexdigest().lower()

# 使用示例
if __name__ == "__main__":
    # 替换为实际值
    APP_SECRET = "******************"
    ACCESS_TOKEN = "*************************")
    TIDS = "1234567789"  # 示例参数，需按文档调整

    client = AgisoApiClient(APP_SECRET, ACCESS_TOKEN)
    result = client.logistics_dummy_send(TIDS)
    print("接口响应:", result)
```

--------------------------------

### C#: Send Dummy Logistics Data

Source: https://open.agiso.com/document/#/alds/guide

This C# code snippet demonstrates how to call the Agiso API to send dummy logistics data. It includes logic for authentication, timestamp generation, parameter signing using MD5, and constructing the POST request.

```csharp
public String LogisticsDummySend() {
    string accessToken = "*************";
    string appSecret = "*************";
    WebRequest apiRequest = WebRequest.Create("https://gw-api.agiso.com/alds/Trade/LogisticsDummySend");
    apiRequest.Method = "POST";
    apiRequest.ContentType = "application/x-www-form-urlencoded";
    apiRequest.Headers.Add("Authorization", "Bearer " + accessToken);
    apiRequest.Headers.Add("ApiVersion", "1");
    //业务参数
    TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
    var args = new Dictionary<string,string>() {
        {"tids","123456789,987465123"},
        注意 tids是示例参数实际参数要以当前文档上的入参为准！！！
        {"timestamp",Convert.ToInt64(ts.TotalSeconds).ToString()}
    };
    args.Add("sign", Sign(args, appSecret));
    //拼装POST数据
    string postData = "";
    foreach (var p in args) {
        if (!String.IsNullOrEmpty(postData)) {
            postData += "&";
        }
        string tmpStr = String.Format("{0}={1}", p.Key, HttpUtility.UrlEncode(p.Value));
        postData += tmpStr;
    }
    using(var sw = new StreamWriter(apiRequest.GetRequestStream())) {
        sw.Write(postData);
    }
    WebResponse apiResponse = null;
    try {
        apiResponse = apiRequest.GetResponse();
    } catch (WebException we) {
        if (we.Status == WebExceptionStatus.ProtocolError) {
            apiResponse = (we.Response as HttpWebResponse);
        }
        else{
            //TODO:处理异常
            return "";
        }
    }
    using(Stream apiDataStream = apiResponse.GetResponseStream()){
        using(StreamReader apiReader = new StreamReader(apiDataStream, Encoding.UTF8)){
            string apiResult = apiReader.ReadToEnd();
            apiReader.Close();
            apiResponse.Close();
            return apiResult;
        }
    }
}
```

```csharp
public string Sign(IDictionary<string,string> args, string ClientSecret) {
    IDictionary<string, string> sortedParams = new SortedDictionary<string, string>(args, StringComparer.Ordinal);
    string str = "";
    foreach (var m in sortedParams) {
        str += (m.Key + m.Value);
    }
    //头尾加入AppSecret
    str = ClientSecret + str + ClientSecret;
    var encodeStr = MD5Encrypt(str);
    return encodeStr;
}
```

```csharp
public static string MD5Encrypt(string text) {
    MD5 md5 = new MD5CryptoServiceProvider();
    byte[] fromData = System.Text.Encoding.UTF8.GetBytes(text);
    byte[] targetData = md5.ComputeHash(fromData);
    string byte2String = null;
    for (int i = 0; i < targetData.Length; i++) {
        byte2String += targetData[i].ToString("x2");
    }
    return byte2String;
}
```

--------------------------------

### Java: Send Dummy Logistics Data

Source: https://open.agiso.com/document/#/alds/guide

Use this Java code to send dummy logistics data to the Agiso API. It handles authentication, parameter signing, and POST request execution. Ensure you have the necessary HTTP client libraries.

```java
public String logisticsDummySend() {
    String appSecret = "******************";
    String accessToken = "*************************";
    CloseableHttpClient httpclient = HttpClients.createDefault();
    HttpPost httpPost = new HttpPost("https://gw-api.agiso.com/alds/Trade/LogisticsDummySend");
    // 设置头部
    httpPost.addHeader("Authorization", "Bearer " + accessToken);
    httpPost.addHeader("ApiVersion", "1");
    //业务参数
    Map<String, String> data = new HashMap<String, String>();
    String tids = "1234567789,9874561233";
    data.put("tids", tids);
    注意 tids是示例参数实际参数要以当前文档上的入参为准！！！
    Long timestamp = System.currentTimeMillis() / 1000;
    data.put("timestamp", timestamp.toString());
    // 参数签名
    try {
        data.put("sign", sign(data, appSecret));
    } catch (NoSuchAlgorithmException e) {
        e.printStackTrace();
    } catch (UnsupportedEncodingException e) {
        e.printStackTrace();
    }
    List<BasicNameValuePair> params = new ArrayList<BasicNameValuePair>();
    for (Map.Entry<String, String> entry : data.entrySet()) {
        params.add(new BasicNameValuePair(entry.getKey(), entry.getValue()));
    }
    // 发起POST请求
    try {
        httpPost.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));
        HttpResponse httpResponse = httpclient.execute(httpPost);
        if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
            return EntityUtils.toString(httpResponse.getEntity());
        }
        else {
            return ("doPost Error Response: " + httpResponse.getStatusLine().toString());
        }
    } catch (Exception e) {
        e.printStackTrace();
        return null;
    }
}
```

```java
public String sign(Map<String, String> params, String appSecret) throws NoSuchAlgorithmException, UnsupportedEncodingException {
    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);
    StringBuilder query = new StringBuilder();
    query.append(appSecret);
    for (String key : keys) {
        String value = params.get(key);
        query.append(key).append(value);
    }
    query.append(appSecret);
    byte[] md5byte = encryptMD5(query.toString());
    return byte2hex(md5byte);
}
```

```java
public static String byte2hex(byte[] bytes) {
    StringBuilder sign = new StringBuilder();
    for (int i = 0; i < bytes.length; i++) {
        String hex = Integer.toHexString(bytes[i] & 0xFF);
        if (hex.length() == 1) {
            sign.append("0");
        }
        sign.append(hex.toLowerCase());
    }
    return sign.toString();
}
```

```java
public static byte[] encryptMD5(String data) throws NoSuchAlgorithmException, UnsupportedEncodingException {
    MessageDigest md5 = MessageDigest.getInstance("MD5");
    return md5.digest(data.getBytes("UTF-8"));
}
```

--------------------------------

### PHP: Simulate Logistics Dummy Send API Call

Source: https://open.agiso.com/document/#/alds/guide

This PHP function demonstrates how to call the LogisticsDummySend API. It prepares parameters, generates a signature using a helper function, and makes a cURL request. Ensure you replace placeholder secrets and tokens with actual values.

```php
function LogisticsDummySend(){
 $appSecret = "******************";
 $accessToken = "*************************";
 //业务参数
 $params = array();
 $params['tids'] = '123456789,987456123';
 注意 tids是示例参数实际参数要以当前文档上的入参为准！！！
 $params['timestamp'] = time();
 $params['sign'] = sign($params,$appSecret);
 //设置Header
 $headers[] = "Authorization: Bearer ".$accessToken;
 $headers[] = "ApiVersion: 1";
 $ci = curl_init();
 curl_setopt($ci, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);
 curl_setopt($ci, CURLOPT_RETURNTRANSFER, TRUE);
 curl_setopt($ci, CURLOPT_ENCODING, "");
 if (version_compare(phpversion(), '5.4.0', '<')) {
 curl_setopt($ci, CURLOPT_SSL_VERIFYHOST, 1);
 } else {
 curl_setopt($ci, CURLOPT_SSL_VERIFYHOST, 2);
 }
 curl_setopt($ci, CURLOPT_HEADER, FALSE);
 curl_setopt($ci, CURLOPT_POST, TRUE);
 curl_setopt($ci, CURLOPT_POSTFIELDS, $params);
 curl_setopt($ci, CURLOPT_URL, 'https://gw-api.agiso.com/alds/Trade/LogisticsDummySend' );
 curl_setopt($ci, CURLOPT_HTTPHEADER, $headers );
 curl_setopt($ci, CURLINFO_HEADER_OUT, TRUE );
 $response = curl_exec($ci);
 curl_close ($ci);
 return $response;
}
function sign($args,$client_secret) {
 ksort($args);
 $str='';
 foreach ($args as $key => $value) {
 $str .= ($key . $value);
 }
 //头尾加入AppSecret
 $str = $client_secret . $str . $client_secret;
 $encodeStr = md5($str);
 return $encodeStr;
}
```
Tokens:
Raw