接口名称：全国快递物流查询

 
                                                         
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.security.MessageDigest;

/**
 * 全国物流快递查询 - Java 示例代码
 * 接口地址：https://api.shuxuntech.com/v1/express/query
 *
 * 说明：本示例只使用 JDK 原生 API（java.net / java.security），不依赖任何第三方 jar 包，
 *      也不需要本项目的工具类，复制到本地即可编译运行：
 *          javac ExpressQueryDemo.java
 *          java ExpressQueryDemo
 */
public class ExpressQueryDemo {

    /** 数勋分配的 appKey，请替换为您自己的 appKey */
    private static final String APP_KEY = "您的appKey";
    /** 数勋分配的 appSecret，请替换为您自己的 appSecret */
    private static final String APP_SECRET = "您的appSecret";
    /** 接口地址 */
    private static final String API_URL = "https://api.shuxuntech.com/v1/express/query";
    /** 快递编号 */
    private static final String NO = "";
    /** 快递代码 */
    private static final String CODE = "";
    /** 顺丰速运/丰网速运需传入收件人或寄件人手机号或手机号后四位 */
    private static final String TEL = "";

    public static void main(String[] args) throws Exception {
        // 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
        String timestamp = String.valueOf(System.currentTimeMillis());

        // 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256，得到小写十六进制字符串
        String sign = sha256Hex(APP_KEY + timestamp + APP_SECRET);

        // 3、业务参数，拼到 url 的 query 里
        String query = "no=" + urlEncode(NO) + "&" + "code=" + urlEncode(CODE) + "&" + "tel=" + urlEncode(TEL);
        String url = API_URL + (query.isEmpty() ? "" : "?" + query);

        // 4、发起 GET 请求，appKey、timestamp、sign 放在请求头
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        conn.setRequestProperty("appKey", APP_KEY);
        conn.setRequestProperty("timestamp", timestamp);
        conn.setRequestProperty("sign", sign);
        conn.setConnectTimeout(10000);
        conn.setReadTimeout(20000);

        int status = conn.getResponseCode();
        // 5、读取返回内容：报错时读错误流，避免只拿到一个异常看不到原因
        InputStream in = (status >= 200 && status < 300) ? conn.getInputStream() : conn.getErrorStream();
        String result = readAll(in);
        conn.disconnect();

        System.out.println("HTTP状态码=" + status);
        System.out.println("返回结果=" + result);
    }

    /**
     * sha256 加密，返回小写十六进制字符串
     * 服务端校验签名用的就是这个算法（小写十六进制）
     */
    private static String sha256Hex(String content) throws Exception {
        byte[] bytes = MessageDigest.getInstance("SHA-256").digest(content.getBytes("UTF-8"));
        StringBuilder sb = new StringBuilder(bytes.length * 2);
        for (byte b : bytes) {
            sb.append(Character.forDigit((b >> 4) & 0xF, 16));
            sb.append(Character.forDigit(b & 0xF, 16));
        }
        return sb.toString();
    }

    /** url 编码，中文参数需要编码 */
    private static String urlEncode(String value) throws Exception {
        return URLEncoder.encode(value, "UTF-8");
    }

    /** 读取输入流内容 */
    private static String readAll(InputStream in) throws Exception {
        if (in == null) {
            return "";
        }
        StringBuilder sb = new StringBuilder();
        BufferedReader reader = new BufferedReader(new InputStreamReader(in, "UTF-8"));
        try {
            String line;
            while ((line = reader.readLine()) != null) {
                sb.append(line);
            }
        } finally {
            reader.close();
        }
        return sb.toString();
    }
}


                                                     

 
                                                         
# 全国物流快递查询 - Python 示例代码
# 接口地址：https://api.shuxuntech.com/v1/express/query
#
# 说明：只使用 Python 标准库（urllib / hashlib / time），不需要 pip 安装任何第三方包，
#      保存为 express_query_demo.py 后直接执行 python express_query_demo.py 即可。

import hashlib
import time
import urllib.error
import urllib.parse
import urllib.request

# 数勋分配的 appKey，请替换为您自己的 appKey
APP_KEY = "您的appKey"
# 数勋分配的 appSecret，请替换为您自己的 appSecret
APP_SECRET = "您的appSecret"
# 接口地址
API_URL = "https://api.shuxuntech.com/v1/express/query"
# 快递编号
NO = ""
# 快递代码
CODE = ""
# 顺丰速运/丰网速运需传入收件人或寄件人手机号或手机号后四位
TEL = ""


def sha256_hex(content):
    """sha256 加密，返回小写十六进制字符串，服务端校验签名用的就是这个算法"""
    return hashlib.sha256(content.encode("utf-8")).hexdigest()


def main():
    # 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
    timestamp = str(int(time.time() * 1000))

    # 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
    sign = sha256_hex(APP_KEY + timestamp + APP_SECRET)

    # 3、业务参数
    params = {}
    params["no"] = NO
    params["code"] = CODE
    params["tel"] = TEL
    data = urllib.parse.urlencode(params)

    # 4、发起 GET 请求，appKey、timestamp、sign 放在请求头
    request = urllib.request.Request(API_URL + ("?" + data if data else ""), method="GET")
    request.add_header("appKey", APP_KEY)
    request.add_header("timestamp", timestamp)
    request.add_header("sign", sign)

    # 5、读取返回内容：报错时也把返回体读出来，避免只拿到一个异常看不到原因
    try:
        with urllib.request.urlopen(request, timeout=20) as response:
            status = response.getcode()
            body = response.read().decode("utf-8")
    except urllib.error.HTTPError as e:
        status = e.code
        body = e.read().decode("utf-8")

    print("HTTP状态码=" + str(status))
    print("返回结果=" + body)

if __name__ == "__main__":
    main()


                                                     

 
                                                         
<?php
/**
 * 全国物流快递查询 - PHP 示例代码
 * 接口地址：https://api.shuxuntech.com/v1/express/query
 *
 * 说明：只使用 PHP 内置函数，不需要 composer 安装任何依赖，也不需要 curl 扩展，
 *      保存为 express_query_demo.php 后直接执行 php express_query_demo.php 即可。
 */

// 数勋分配的 appKey，请替换为您自己的 appKey
$appKey = "您的appKey";
// 数勋分配的 appSecret，请替换为您自己的 appSecret
$appSecret = "您的appSecret";
// 接口地址
$url = "https://api.shuxuntech.com/v1/express/query";
// 快递编号
$no = "";
// 快递代码
$code = "";
// 顺丰速运/丰网速运需传入收件人或寄件人手机号或手机号后四位
$tel = "";

// 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
$timestamp = sprintf('%.0f', microtime(true) * 1000);

// 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
$sign = hash('sha256', $appKey . $timestamp . $appSecret);

// 3、业务参数
$params = array(
    'no' => $no,
    'code' => $code,
    'tel' => $tel,
);
$body = http_build_query($params);

// 4、发起 GET 请求，appKey、timestamp、sign 放在请求头
$context = stream_context_create(array(
    'http' => array(
        'method' => 'GET',
        'header' => "appKey: {$appKey}\r\n"
            . "timestamp: {$timestamp}\r\n"
            . "sign: {$sign}\r\n",
        'timeout' => 20,
        // 返回 4xx、5xx 时也把返回体读出来，方便排查
        'ignore_errors' => true,
    ),
));
$requestUrl = ($body === '') ? $url : $url . '?' . $body;
$result = file_get_contents($requestUrl, false, $context);
// 打印结果
if (!empty($http_response_header[0])) {
    echo "HTTP状态=" . $http_response_header[0] . PHP_EOL;
}
echo "返回结果=" . $result . PHP_EOL;


                                                     

 
                                                         
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Security.Cryptography;
using System.Text;

/**
 * 全国物流快递查询 - C# 示例代码
 * 接口地址：https://api.shuxuntech.com/v1/express/query
 *
 * 说明：只使用 .NET 基础类库（System.Net.Http / System.Security.Cryptography），不依赖任何第三方包。
 *      需要 .NET Framework 4.5 及以上，或 .NET Core / .NET 5 及以上；
 *      保存为 ExpressQueryDemo.cs 后，用 dotnet run 或 VS 控制台项目直接运行即可。
 */
public class ExpressQueryDemo
{
    /** 数勋分配的 appKey，请替换为您自己的 appKey */
    private const string AppKey = "您的appKey";
    /** 数勋分配的 appSecret，请替换为您自己的 appSecret */
    private const string AppSecret = "您的appSecret";
    /** 接口地址 */
    private const string ApiUrl = "https://api.shuxuntech.com/v1/express/query";
    /** 快递编号 */
    private const string No = "";
    /** 快递代码 */
    private const string Code = "";
    /** 顺丰速运/丰网速运需传入收件人或寄件人手机号或手机号后四位 */
    private const string Tel = "";

    public static void Main(string[] args)
    {
        // 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
        long millis = (long)(DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalMilliseconds;
        string timestamp = millis.ToString();

        // 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
        string sign = Sha256Hex(AppKey + timestamp + AppSecret);

        // 3、业务参数
        Dictionary<string, string> form = new Dictionary<string, string>();
        form.Add("no", No);
        form.Add("code", Code);
        form.Add("tel", Tel);
        string body = ToFormBody(form);

        // 4、发起 GET 请求，appKey、timestamp、sign 放在请求头
        using (HttpClient client = new HttpClient())
        {
            client.Timeout = TimeSpan.FromSeconds(20);
            client.DefaultRequestHeaders.Add("appKey", AppKey);
            client.DefaultRequestHeaders.Add("timestamp", timestamp);
            client.DefaultRequestHeaders.Add("sign", sign);

            string url = (body == "") ? ApiUrl : ApiUrl + "?" + body;
            HttpResponseMessage response = client.GetAsync(url).GetAwaiter().GetResult();

            // 5、读取返回内容，4xx、5xx 时 HttpClient 不会抛异常，这里同样能拿到返回体
            string content = response.Content.ReadAsStringAsync().GetAwaiter().GetResult();

            Console.WriteLine("HTTP状态码=" + (int)response.StatusCode);
            Console.WriteLine("返回结果=" + content);
        }
    }

    /** 拼装 application/x-www-form-urlencoded 内容，中文参数需要编码 */
    private static string ToFormBody(Dictionary<string, string> form)
    {
        StringBuilder sb = new StringBuilder();
        foreach (KeyValuePair<string, string> item in form)
        {
            if (sb.Length > 0)
            {
                sb.Append("&");
            }
            sb.Append(Uri.EscapeDataString(item.Key)).Append("=").Append(Uri.EscapeDataString(item.Value));
        }
        return sb.ToString();
    }

    /** sha256 加密，返回小写十六进制字符串，服务端校验签名用的就是这个算法 */
    private static string Sha256Hex(string content)
    {
        using (SHA256 sha256 = SHA256.Create())
        {
            byte[] bytes = sha256.ComputeHash(Encoding.UTF8.GetBytes(content));
            StringBuilder sb = new StringBuilder(bytes.Length * 2);
            foreach (byte b in bytes)
            {
                sb.Append(b.ToString("x2"));
            }
            return sb.ToString();
        }
    }
}


                                                     

 
                                                         
// 全国物流快递查询 - Node.js 示例代码
// 接口地址：https://api.shuxuntech.com/v1/express/query
//
// 说明：只使用 Node.js 内置模块（https / crypto），不需要 npm 安装任何第三方包，
//      保存为 express_query_demo.js 后直接执行 node express_query_demo.js 即可（需 Node 10 及以上）。

const https = require('https');
const crypto = require('crypto');

// 数勋分配的 appKey，请替换为您自己的 appKey
const APP_KEY = '您的appKey';
// 数勋分配的 appSecret，请替换为您自己的 appSecret
const APP_SECRET = '您的appSecret';
// 接口地址
const API_URL = 'https://api.shuxuntech.com/v1/express/query';
// 快递编号
const NO = '';
// 快递代码
const CODE = '';
// 顺丰速运/丰网速运需传入收件人或寄件人手机号或手机号后四位
const TEL = '';

// sha256 加密，返回小写十六进制字符串，服务端校验签名用的就是这个算法
function sha256Hex(content) {
    return crypto.createHash('sha256').update(content, 'utf8').digest('hex');
}

// 打印返回结果
function printResult(statusCode, body) {
    console.log('HTTP状态码=' + statusCode);
    console.log('返回结果=' + body);
}

// 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
const timestamp = String(Date.now());

// 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
const sign = sha256Hex(APP_KEY + timestamp + APP_SECRET);

// 3、业务参数，放在 url 的 query 里（中文由 URLSearchParams 自动 URL 编码）
const query = new URLSearchParams({ no: NO, code: CODE, tel: TEL }).toString();
const url = query ? API_URL + '?' + query : API_URL;

// 4、发起 GET 请求，appKey、timestamp、sign 放在请求头
const request = https.request(url, {
    method: 'GET',
    headers: {
        appKey: APP_KEY,
        timestamp: timestamp,
        sign: sign
    },
    timeout: 20000
}, function (response) {
    // 5、读取返回内容：即使报错（4xx、5xx）也能拿到返回体，避免只看到异常看不到原因
    let body = '';
    response.setEncoding('utf8');
    response.on('data', function (chunk) { body += chunk; });
    response.on('end', function () { printResult(response.statusCode, body); });
});

request.on('timeout', function () {
    request.destroy();
    console.log('请求超时');
});

request.on('error', function (err) {
    console.log('请求异常=' + err.message);
});

request.end();


                                                     

 
                                                         
// 全国物流快递查询 - Go 示例代码
// 接口地址：https://api.shuxuntech.com/v1/express/query
//
// 说明：只使用 Go 标准库（net/http、crypto/sha256、encoding/hex 等），不需要引入任何第三方包，
//      保存为 express_query_demo.go 后直接执行 go run express_query_demo.go 即可。
package main

import (
	"crypto/sha256"
	"encoding/hex"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"time"
)

// 数勋分配的 appKey，请替换为您自己的 appKey
const appKey = "您的appKey"

// 数勋分配的 appSecret，请替换为您自己的 appSecret
const appSecret = "您的appSecret"

// 接口地址
const apiURL = "https://api.shuxuntech.com/v1/express/query"
// 快递编号
const no = ""
// 快递代码
const code = ""
// 顺丰速运/丰网速运需传入收件人或寄件人手机号或手机号后四位
const tel = ""

// sha256 加密，返回小写十六进制字符串，服务端校验签名用的就是这个算法
func sha256Hex(content string) string {
	sum := sha256.Sum256([]byte(content))
	return hex.EncodeToString(sum[:])
}

func main() {
	// 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
	timestamp := fmt.Sprintf("%d", time.Now().UnixNano()/int64(time.Millisecond))

	// 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
	sign := sha256Hex(appKey + timestamp + appSecret)

	// 3、业务参数，放在 url 的 query 里（url.Values 会自动对中文做 URL 编码）
	query := url.Values{}
	query.Set("no", no)
	query.Set("code", code)
	query.Set("tel", tel)
	requestURL := apiURL
	if len(query) > 0 {
		requestURL = apiURL + "?" + query.Encode()
	}

	// 4、发起 GET 请求，appKey、timestamp、sign 放在请求头
	req, err := http.NewRequest("GET", requestURL, nil)
	if err != nil {
		fmt.Println("创建请求失败=" + err.Error())
		return
	}
	req.Header.Set("appKey", appKey)
	req.Header.Set("timestamp", timestamp)
	req.Header.Set("sign", sign)

	client := &http.Client{Timeout: 20 * time.Second}
	resp, err := client.Do(req)
	if err != nil {
		fmt.Println("请求异常=" + err.Error())
		return
	}
	defer resp.Body.Close()

	// 5、读取返回内容：即使报错（4xx、5xx）也能拿到返回体
	body, _ := io.ReadAll(resp.Body)

	fmt.Println("HTTP状态码=" + resp.Status)
	fmt.Println("返回结果=" + string(body))
}


                                                     

 
                                                         
#!/usr/bin/env bash
# 全国物流快递查询 - curl 示例代码
# 接口地址：https://api.shuxuntech.com/v1/express/query
#
# 说明：只依赖系统自带的 curl 和 openssl（用于计算 sha256），不需要安装任何第三方工具，
#      保存为 express_query_demo.sh 后直接执行 bash express_query_demo.sh 即可。
#      如果系统没有 openssl，可把下面 SIGN 那一行换成注释里的 sha256sum 写法。

# 数勋分配的 appKey，请替换为您自己的 appKey
APP_KEY="您的appKey"
# 数勋分配的 appSecret，请替换为您自己的 appSecret
APP_SECRET="您的appSecret"
# 接口地址
API_URL="https://api.shuxuntech.com/v1/express/query"
# 快递编号
NO=""
# 快递代码
CODE=""
# 顺丰速运/丰网速运需传入收件人或寄件人手机号或手机号后四位
TEL=""

# 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
TIMESTAMP=$(($(date +%s) * 1000))

# 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256，得到小写十六进制字符串
#    没有 openssl 时可用： SIGN=$(printf '%s' "${APP_KEY}${TIMESTAMP}${APP_SECRET}" | sha256sum | awk '{print $1}')
SIGN=$(printf '%s' "${APP_KEY}${TIMESTAMP}${APP_SECRET}" | openssl dgst -sha256 | awk '{print $NF}')

# 3、业务参数放在 url 的 query 里（--data-urlencode 会自动对中文做 URL 编码）

# 4、发起 GET 请求，appKey、timestamp、sign 放在请求头
# 5、-w 参数在返回内容后打印 HTTP 状态码，便于查看结果
curl -sS -G "${API_URL}" \
    -H "appKey: ${APP_KEY}" \
    -H "timestamp: ${TIMESTAMP}" \
    -H "sign: ${SIGN}" \
    --data-urlencode "no=${NO}" \
    --data-urlencode "code=${CODE}" \
    --data-urlencode "tel=${TEL}" \
    -w "\nHTTP状态码=%{http_code}\n"