快递查询
其他 官方文档
可根据快递单号查询大部分主流快递的快递信息
基本说明:
接口地址:http://api.kuaidi.com/openapi.html
返回格式:json
请求方式:get
请求示例:http://api.kuaidi.com/openapi.html?id=[]&com=[]&nu=[]&show=[0|1]&muti=[0|1]&order=[desc|asc]
请求参数说明:
名称 类型 必填 说明
id string 必填 身份授权Key(大小敏感)
com string 必填 要查询的快递公司代码
nu string 必填 要查询的快递单号,请勿带特殊符号,不支持中文(大小不敏感)
show string 选填 返回类型。0:返回json字符串,1:返回xml对象 不填默认json字符串
muti string 选填 返回信息数量,0:返回多行完整的信息,1:只返回一行信息。不填默认返回多行
order string 选填 排序。desc:按时间由新到旧排列,asc:按时间由旧到新排列。不填默认desc(大小不敏感)
返回参数说明:
名称 类型 说明
success string 返回状态:true 成功 ,false 失败
status int 运单的当前状态:0物流单号暂无结果,3在途,4 揽件,5 疑难,6签收,7退签,8 派件,9 退回
reason string 如果请求失败,失败原因
data object 数据集合
time string 每条数据的时间
context string 每条数据的内容
JSON返回示例:
{
	"success": true,
	"reason": "",
	"data": [{
			"time": "2015-10-20 18:35:13",
			"context": "\u5df2\u7b7e\u6536,\u7b7e\u6536\u4eba\u662f:\u95e8\u536b\u7b7e\u6536"
		},
		{
			"time": "2015-10-20 10:20:17",
			"context": "\u56db\u5ddd\u8fbe\u5dde\u5927\u7af9\u516c\u53f8\r\r\u7684\u6d3e\u4ef6\u5458\u7	 18a\u59d0\u6b63\u5728\u6d3e\u4ef6"
		},
		{
			"time": "2015-10-20 09:40:40",
			"context": "\u5feb\u4ef6\u5df2\u5230\u8fbe\u56db\u5ddd\u8fbe\u5dde\u5927\u7af9\u516c\u53f8"
		},
		{
			"time": "2015-10-20 03:00:23",
			"context": "\u56db\u5ddd\u5357\u5145\u4e2d\u8f6c\u90e8\r\r\u6b63\u5728\u8fdb\u884c\u88c5\u8	 f66\u626b\u63cf"
		},
		{
			"time": "2015-10-20 03:00:23",
			"context": "\u7531\u56db\u5ddd\u5357\u5145\u4e2d\u8f6c\u90e8\r\r\u53d1\u5f80\u56db\u5ddd\u8	 fbe\u5dde\u5927\u7af9\u516c\u53f8"
		},
		{
			"time": "2015-10-17 23:49:41",
			"context": "\u7531\u4e0a\u6d77\u822a\u7a7a\u90e8\r\r\u53d1\u5f80\u56db\u5ddd\u6210\u90fd\u8	 22a\u7a7a\u90e8"
		},
		{
			"time": "2015-10-17 21:10:16",
			"context": "\u7531\u6c5f\u82cf\u5434\u6c5f\u516c\u53f8\r\r\u53d1\u5f80\u4e0a\u6d77\u822a\u7	 a7a\u90e8"
		},
		{
			"time": "2015-10-17 20:57:19",
			"context": "\u7531\u6c5f\u82cf\u5434\u6c5f\u516c\u53f8\r\r\u53d1\u5f80\u4e0a\u6d77\u822a\u7	 a7a\u90e8"
		},
		{
			"time": "2015-10-17 20:57:19",
			"context": "\u6c5f\u82cf\u5434\u6c5f\u516c\u53f8\r\r\u6b63\u5728\u8fdb\u884c\u88c5\u888b\u6	 26b\u63cf"
		},
		{
			"time": "2015-10-17 20:23:17",
			"context": "\u6c5f\u82cf\u5434\u6c5f\u516c\u53f8\r\r\u7684\u6536\u4ef6\u5458\u9ece\u91cc\u7	 247\u533a\u6dd8\u5b9d\u5df2\u6536\u4ef6"
		}
	],
	"status": 6
}
服务级错误码参照
错误码 说明
- -
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2019/9/3 23:10
 */
//----------------------------------
// 快递查询 调用类
//----------------------------------
class freeApi{
    private $apiUrl;

    public function __construct($ak){
        $this->apiUrl = 'http://api.kuaidi.com/openapi.html?id=[]&com=[]&nu=[]&show=[0|1]&muti=[0|1]&order=[desc|asc]';
    }
    /**
     * 获取结果
     * @return array
     */
    public function getResult(){
        return $this->freeApiCurl($this->apiUrl);
    }
    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @param  int $ipost [是否采用POST形式]
     * @return  string
     */
    public function freeApiCurl($url,$params=false,$ispost=0){
        $ch = curl_init();
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_USERAGENT , 'free-api' );
        curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
        curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
        curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );
        if( $ispost )
        {
            curl_setopt( $ch , CURLOPT_POST , true );
            curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );
            curl_setopt( $ch , CURLOPT_URL , $url );
        }
        else
        {
            if($params){
                curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );
            }else{
                curl_setopt( $ch , CURLOPT_URL , $url);
            }
        }
        $response = curl_exec( $ch );
        if ($response === FALSE) {
            return false;
        }
        curl_close( $ch );
        return $response;
    }
}