接口文档

为您提供全面的新手入门文档和教程,方便您轻松上手。

全球快递物流(含轨迹)查询

正常 按量计费

支持国内外1500多家快递物流公司,提供物流轨迹,与官网同步数据更新。

更新日期
2023-05-03
免费额度
5 次
计费单价
0.01元/次
每日限制
无限制
QPS限制
1秒10次
单独包月价格

接口地址:https://api.itapi.cn/api/kuaidi/v2

返回格式:application/json

请求方式:HTTPGET

请求参数:

参数名称 类型 必填 说明
key string 用户请求密钥,可在 密钥管理页面 申请
comstring快递公司名(默认自动获取)
numberstring快递单号
phonestring收件人或寄件人电话号码后四位,仅顺丰需要

返回参数:

参数名称 类型 说明
stateint0 查询成功 1 输入参数错误 2 查不到物流信息 3 单号不符合规则 4 快递公司编码不符合规则 5 快递查询渠道异常 6 auto时未查到单号对应的快递公司,请指定快递公司编码 7 单号与手机号不匹配 其他参数:接口调用失败 101 揽件 102 在途中 103 派送中 104 已签收 (完结状态) 105 用户拒签 106 疑难件 107 无效单 (完结状态) 108 超时单 109 签收失败 110 退回 111 转投 112 待签
comstring快递公司编码
telstring快递公司联系方式
data.timestring发生的时间
data.contextstring跟踪信息
data.locationstring位置对应的坐标信息,坐标系是:GCJ-02
data.addressstring位置信息
data.statusstring101 揽件 102 在途中 103 派送中 104 已签收 (完结状态) 105 用户拒签 106 疑难件 107 无效单 (完结状态) 108 超时单 109 签收失败 110 退回 111 转投 112 待签
com_namestring快递公司名称
delivery_timestring预计到达时间
possible_com_listarray仅自动获取快递公司时查询失败返回
possible_com_list.comstring快递公司编码
possible_com_list.com_namestring快递公司名称
update_timestring 更新时间
nustring快递单号
logostring快递公司logo(暂无)

返回示例:

系统错误代码:

代号 说明
200 成功
400 限制或者错误
403 权限问题
500 服务器内部错误
按量付费
按量套餐 套餐规格 价格
所有会员 无限 次 / 天 10点 / 次 ≈0.01元 / 次
* 点数支持所有标注为按量计费的产品抵扣。
次数包
使用期限 套餐规格 价格
一个月1200 次 10 元  0.008/次
一年10000 次 45 元  0.005/次
一年100000 次 400 元  0.004/次
一年270000 次 1000 元  0.004/次
* 套餐使用时限为订购之日起开始计算,每日请求限制无限制,用完即止。

<?php
/**
 * API请求DEMO
 *
 * 本demo支持GET与POST请求,同时支持签名验证与无需签名。
 */

//你申请的key密钥
$API_KEY = '你的接口密钥,登录控制台后在密钥管理页面申请';

//API接口地址
$API_URL = 'https://api.itapi.cn/api/kuaidi/v2';

$post_data = array(
    //接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
    'key' => $API_KEY,
    'com' => '快递公司名(默认自动获取)',
    'number' => '快递单号',
    'phone' => '收件人或寄件人电话号码后四位,仅顺丰需要',
    );

$resdata = curl_send($API_URL, $post_data, 'POST');

//打印请求结果
print($resdata);

function curl_send($url, $post_data, $type = 'GET', $ifsign = '', $sk = '', $outime = 20)
{
	$get_post_data = http_build_query($post_data);
    $ch = curl_init();
    if ($type == 'POST') {
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $get_post_data);
    } elseif ($type == 'GET') {
        curl_setopt($ch, CURLOPT_URL, $url . '?' . $get_post_data);
    }
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, $outime);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
    curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36"); // 伪造ua
    curl_setopt($ch, CURLOPT_REFERER, $url);
    if ($ifsign) {
        $sign = md5($get_post_data . $sk);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['sign:' . $sign]);
    }
    curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
    $data = curl_exec($ch);
    if ($data === false) {
        msg(500, curl_error($ch));
    }
    curl_close($ch);
    return $data;
}



//jQuery-Ajax
$.ajax({
	url: 'https://api.itapi.cn/api/kuaidi/v2',
	data: {
	//接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
		key: '你的接口密钥,登录控制台后在密钥管理页面申请',
		参数名: '参数值',

	},
	type: 'GET', //请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
	dataType: 'json',
	success: function(data) {
		console.log(data); //请求成功,输出结果到控制台
	},
	timeout: 3000, //超时时间
	error: function(data) {
		console.log('请求失败'); //失败处理
	}
});



import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class Test {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.itapi.cn/api/kuaidi/v2?key=你的接口密钥,登录控制台后在密钥管理页面申请");
            HttpURLConnection connection = (HttpURLConnection)url.openConnection();

            // 设置请求方式
            connection.setRequestMethod("GET");
            connection.connect();

            // 获取响应码
            int responseCode = connection.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String line;
                while ((line = reader.readLine()) != null) {
                    // 读取到的内容给line变量
                    System.out.println(line);
                }
                reader.close();
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}


package main

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

func main() {
    // 发起一个GET请求
    resp, err := http.Get("https://api.itapi.cn/api/kuaidi/v2?key=你的接口密钥,登录控制台后在密钥管理页面申请")
    if err != nil {
        fmt.Println("http get error", err)
        return
    }

    // 读取响应结果
    result, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("http read error", err)
        return
    }

    // 关闭响应结果
    defer resp.Body.Close()

    fmt.Println(string(result))
}



# 导入requests库
import requests

# 设置url
url = 'https://api.itapi.cn/api/kuaidi/v2?key=你的接口密钥,登录控制台后在密钥管理页面申请'

# 发送post请求
response = requests.post(url, data={'key1': 'value1', 'key2': 'value2'})

# 获取响应内容
result = response.json()

# 打印结果
print(result)


// 以下是使用Node.js进行GET和POST请求API接口的示例代码:

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

// 定义请求选项
const options = {
  hostname: 'api.itapi.cn',
  path: '/api/kuaidi/v2',
  method: 'GET'
};

// 发送GET请求
https.get(options, res => {
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', d => {
    process.stdout.write(d);
  });
}).on('error', error => {
  console.error(error);
});

// 发送POST请求
const postData = querystring.stringify({
  'key1': 'value1',
  'key2': 'value2'
});

const postOptions = {
  hostname: 'api.itapi.cn',
  path: '/api/kuaidi/v2',
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
    'Content-Length': Buffer.byteLength(postData)
  }
};

const postReq = https.request(postOptions, res => {
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', d => {
    process.stdout.write(d);
  });
});

postReq.on('error', error => {
  console.error(error);
});

postReq.write(postData);
postReq.end();



#include 
#include 
#include 
#include  // 需要安装curl库

// API地址
const char* url = "https://api.itapi.cn/api/kuaidi/v2";

// GET请求
void getRequest(CURL* curl) {
    CURLcode res;

    // 设置URL
    curl_easy_setopt(curl, CURLOPT_URL, url);

    // 执行请求
    res = curl_easy_perform(curl);

    if(res != CURLE_OK) {
        fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
    }
}

// POST请求
void postRequest(CURL* curl) {
    CURLcode res;

    // 设置URL
    curl_easy_setopt(curl, CURLOPT_URL, url);

    // 设置POST数据
    const char* postData = "key=你的接口密钥,登录控制台后在密钥管理页面申请&key1=value1";
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);

    // 执行请求
    res = curl_easy_perform(curl);

    if(res != CURLE_OK) {
        fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
    }
}

int main() {
    CURL* curl;
    CURLcode res;

    // 初始化curl
    curl = curl_easy_init();

    if(curl) {
        // 设置SSL验证
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);

        // GET请求
        getRequest(curl);

        // POST请求
        postRequest(curl);

        // 清理curl资源
        curl_easy_cleanup(curl);
    }

    return 0;
}



#include 
#include 

int main() {
    CURL *curl;
    CURLcode res;
    std::string url = "https://api.itapi.cn/api/kuaidi/v2?key=你的接口密钥,登录控制台后在密钥管理页面申请";
    std::string response;

    curl = curl_easy_init();
    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, [](char *ptr, size_t size, size_t nmemb, void *userdata) -> size_t {
            std::string *response = reinterpret_cast(userdata);
            response->append(ptr, size * nmemb);
            return size * nmemb;
        });
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        res = curl_easy_perform(curl);
        if (res == CURLE_OK) {
            std::cout << "Response: " << response << std::endl;
        } else {
            std::cerr << "Error: " << curl_easy_strerror(res) << std::endl;
        }
        curl_easy_cleanup(curl);
    }

    return 0;
}



using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main(string[] args) {
        HttpClient client = new HttpClient();
        string url = "https://api.itapi.cn/api/kuaidi/v2?key=你的接口密钥,登录控制台后在密钥管理页面申请";
        HttpResponseMessage response = await client.GetAsync(url);
        if (response.IsSuccessStatusCode) {
            string responseBody = await response.Content.ReadAsStringAsync();
            Console.WriteLine("Response: " + responseBody);
        } else {
            Console.WriteLine("Error: " + response.StatusCode);
        }
    }
}

参数名 填写参数值
接口目录

仅需三步即可快速接入

1
在线调试

填写业务相关参数免费在线调试

2
生成代码

生成符合你的开发语言代码,复制即可

3
业务上线

调整你后端部分逻辑代码即可上线使用

数据驱动未来

立即注册

微信
加我为好友
微信号:Devservice

QQ

咨询