express-query-v2

快递单号查询

提供快递单号查询API服务，便于开发者快速查询快递单号相关信息并集成到业务系统。

调用价格

5 匠币/次

快速接入请求字段响应字段接口简介

快速接入

保持统一返回结构，直接通过服务端发起请求即可接入。

POSThttps://openapi.toolkk.com/v1/express-query-v2

cURL Python Go Java PHP

cURL 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/express-query-v2' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "expCode": "shunfeng",\n  "expNo": "SF1234567890"\n}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/express-query-v2"
payload = {
  "expCode": "shunfeng",
  "expNo": "SF1234567890"
}

headers = {
    "Content-Type": "application/json",
    "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}

response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())

Go 示例

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/v1/express-query-v2"
    payload := []byte("{\n  \"expCode\": \"shunfeng\",\n  \"expNo\": \"SF1234567890\"\n}")

    req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

Java 示例

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ToolkkExample {
    public static void main(String[] args) throws Exception {
        String payload = "{\n  \"expCode\": \"shunfeng\",\n  \"expNo\": \"SF1234567890\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/express-query-v2"))
            .method("POST", HttpRequest.BodyPublishers.ofString(payload))
            .header("Content-Type", "application/json")
            .header("X-API-Key", "YOUR_API_KEY")
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

PHP 示例

<?php

$endpoint = 'https://openapi.toolkk.com/v1/express-query-v2';
$payload = "{\n  \"expCode\": \"shunfeng\",\n  \"expNo\": \"SF1234567890\"\n}";

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-API-Key: YOUR_API_KEY',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

curl_close($ch);
echo $response;

响应示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "status": "已签收",
    "statusDesc": "快件已签收",
    "traces": [
      {
        "time": "2024-01-01 10:00:00",
        "desc": "已签收"
      }
    ]
  }
}

示例用于理解返回结构，实际结果以接口返回为准。

请求字段

从服务端发起请求，并在 X-API-Key 请求头中传入密钥。

请求字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	必填	说明	示例值
expCode	`string`	未标注	未标注	`shunfeng`
expNo	`string`	未标注	未标注	`SF1234567890`

请求示例

{
  "expCode": "shunfeng",
  "expNo": "SF1234567890"
}

鉴权方式: 请求头传入 X-API-Key
默认限流: 600 次/分钟
超时时间: 10000 ms

响应字段

示例用于理解返回结构，实际结果以接口返回为准。

响应字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	必填	说明	示例值
code	`string`	未标注	未标注	`SUCCESS`
message	`string`	未标注	未标注	`success`
data	`object`	未标注	未标注	`{...}`
data.status	`string`	未标注	未标注	`已签收`
data.statusDesc	`string`	未标注	未标注	`快件已签收`
data.traces	`array`	未标注	未标注	`[{"time":"2024-01-01 10:00:00","desc":"已签收"}]`
data.traces[]	`object`	未标注	未标注	`{...}`

响应示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "status": "已签收",
    "statusDesc": "快件已签收",
    "traces": [
      {
        "time": "2024-01-01 10:00:00",
        "desc": "已签收"
      }
    ]
  }
}

快递单号查询API - 提供快递单号查询API服务，便于开发者快速查询快递 | 工具匠

快递单号查询

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

响应示例

接入文档

按承运商和单号查询物流

应用场景

使用与结果解读

轨迹与状态边界

常见问题

成功但没有轨迹怎么办？

可以只传单号自动识别快递公司吗？

相关推荐

支持所有国内外快递吗？

已签收状态可以直接触发退款或结算吗？

快递单号查询

航班列表与参考票价查询

国内航班时刻表查询

航班号数据查询

航班实时状态查询

图片质量评分

英文简历解析

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

响应示例

接入文档

按承运商和单号查询物流

应用场景

使用与结果解读

轨迹与状态边界

常见问题

成功但没有轨迹怎么办？

可以只传单号自动识别快递公司吗？

相关推荐

相关工具

相关 API

支持所有国内外快递吗？

已签收状态可以直接触发退款或结算吗？

快递单号查询

航班列表与参考票价查询

国内航班时刻表查询

航班号数据查询

航班实时状态查询

图片质量评分

英文简历解析