プロジェクトは次のとおりです。開発中のニーズによっては、必然的に速達に関するいくつかの API インターフェースが使用されます。この記事では、主に速達のクエリ API と他の会社との違いを紹介します。

Express Bird

Express 100

Aicha Express
Express 100 や Aicha Express などの Web サイトによって提供されるエクスプレスクエリやその他のインターフェイスを使用したことがある場合は、探しているものが見つかるでしょう。適用されたアカウントまたはキーが毎日 API インターフェイスを呼び出せる回数は制限されており、1 日に 2000 回、1 回に 5000 回に制限される場合もあります。唯一面倒なのは、ユーザーが外部リンクを追加する必要があることです。 Express Bird では、ユーザーが外部リンクを追加する必要はありません。ポータルを持たないユーザーには非常に厳しい要件があり、さらに使用するには超過分を支払う必要があります。

Express Bird

無制限

、
永久に無料です

もちろん、小規模なニーズであれば、Express 100 と Aicha Express がニーズを満たすことができますが、リクエストが多すぎる場合は、ある日、クエリサービスが停止し、製品エクスペリエンスに影響が出る可能性があるため、Express Bird を直接使用して 1 ステップで正しく処理することをお勧めします。アプリケーションシナリオ

注文の物流情報をクエリ

達成可能なニーズ

アプリはエクスプレス物流情報クエリAPIインターフェイスを実装するために直接統合されています Express Bird クエリ API インターフェイスの使用法 (PHP バージョン)

WeChatパブリックアカウントでは、ユーザーに従って注文番号を入力すると、バックエンドが注文番号を識別し、Express Birdに従ってExpress APIインターフェイスにクエリを実行して、自動クエリ機能を実現します

など
Apply Key
http ://www.kdniao.com /ServiceApply.aspx

情報に従って情報を完全に入力し、[申請の送信] をクリックします。

ログインに成功すると、IDやキーなどの情報が表示され、この情報を使用してクエリやその他のインターフェースAPIをリクエストできます

。

ExpressクエリAPIインターフェース

インターフェースドキュメントと各開発言語デモ

クエリAPIインターフェース定義

システムレベル入力パラメータ

アプリケーションレベルの入力パラメータ必須

パラメータ名	タイプ	必須	説明
RequestData	String	R	リクエストの内容、JSON または XML 形式は、DataType
EBusinessID	String	R	User ID
RequestType	String と一致している必要があります	R	リクエストコマンドタイプ：1002
datasign	string	dataコンテンツ署名XML 形式です
		パラメータ名	タイプ

説明

ShipperCodeLogisticCode

返される結果パラメータ

OrderCode	varchar(50)	O	注文番号
varchar(10)	R	Express会社コード
varchar(50)	R	物流注文番号

パラメータ名	タイプ	必須	説明
EBusinessID	Int	R	EコマースユーザーID
注文コード	Varchar( 50 )	O	注文番号
配送業者コード	varchar(10)	R	エクスプレス会社コード
ロジスティックコード	Varchar(50)	R	物流運送状番号
成功	Bool	R	成功かどうか
理由	Varchar(50)	O	失敗の理由
State	Int	R	物流ステータス 1: ピッキング済みアイテム 2: 途中 3: 受け取りのサイン
トレース	Varchar(Max)	R	物流トラックの詳細

物流トラックの詳細

パラメータ名	タイプ	必須	説明
AcceptTime	DateTime	R	Time
AcceptStation	Varchar(50)	R	説明
備考	Varchar(150)	O	備考

リクエストJSONパラメータ

{
    "OrderCode" : "",
    "ShipperCode" : "SF",
    "LogisticCode" : "118650888018"}

ログイン後にコピー

レスポンスJSONパラメータ

{
    "EBusinessID" : "1109259",
    "OrderCode" : "",
    "ShipperCode" : "SF",
    "LogisticCode" : "118461988807",
    "Success" : true,
    "State" : 3,
    "Reason" : null,
    "traces" : [{
            "AcceptTime" : "2014/06/25 08:05:37",
            "AcceptStation" : "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]",
            "Remark" : null
        }, {
            "AcceptTime" : "2014/06/25 04:01:28",
            "AcceptStation" : "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]",
            "Remark" : null
        }, {
            "AcceptTime" : "2014/06/25 01:41:06",
            "AcceptStation" : "快件在 深圳集散中心 [深圳市]",
            "Remark" : null
        }, {
            "AcceptTime" : "2014/06/24 20:18:58",
            "AcceptStation" : "已收件[深圳市]",
            "Remark" : null
        }, {
            "AcceptTime" : "2014/06/24 20:55:28",
            "AcceptStation" : "快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]",
            "Remark" : null
        }, {
            "AcceptTime" : "2014/06/25 10:23:03",
            "AcceptStation" : "派件已签收[深圳市]",
            "Remark" : null
        }, {
            "AcceptTime" : "2014/06/25 10:23:03",
            "AcceptStation" : "签收人是：已签收[深圳市]",
            "Remark" : null
        }
    ]}

ログイン後にコピー

クエリAPIインターフェース使用

PHP開発言語を例として展開

<?php
//电商ID
defined(&#39;EBusinessID&#39;) or define(&#39;EBusinessID&#39;, &#39;请到快递鸟官网申请http://kdniao.com/reg&#39;);
//电商加密私钥，快递鸟提供，注意保管，不要泄漏
defined(&#39;AppKey&#39;) or define(&#39;AppKey&#39;, &#39;请到快递鸟官网申请http://kdniao.com/reg&#39;);
//请求url
defined(&#39;ReqURL&#39;) or define(&#39;ReqURL&#39;, &#39;http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx&#39;);


//调用查询物流轨迹
//---------------------------------------------


$logisticResult=getOrderTracesByJson();
echo logisticResult;


//---------------------------------------------
 
/**
 * Json方式 查询订单物流轨迹
 */
function getOrderTracesByJson(){	$requestData= "{&#39;OrderCode&#39;:&#39;&#39;,&#39;ShipperCode&#39;:&#39;YTO&#39;,&#39;LogisticCode&#39;:&#39;12345678&#39;}";		$datas = array(
        &#39;EBusinessID&#39; => EBusinessID,
        &#39;RequestType&#39; => &#39;1002&#39;,
        &#39;RequestData&#39; => urlencode($requestData) ,
        &#39;DataType&#39; => &#39;2&#39;,
    );
    $datas[&#39;DataSign&#39;] = encrypt($requestData, AppKey);	$result=sendPost(ReqURL, $datas);			//根据公司业务处理返回的信息......		return $result;
}
 
/**
 *  post提交数据 
 * @param  string $url 请求Url
 * @param  array $datas 提交的数据 
 * @return url响应返回的html
 */
function sendPost($url, $datas) {
    $temps = array();	    foreach ($datas as $key => $value) {
        $temps[] = sprintf(&#39;%s=%s&#39;, $key, $value);		    }	    $post_data = implode(&#39;&&#39;, $temps);
    $url_info = parse_url($url);	if(empty($url_info[&#39;port&#39;]))	{		$url_info[&#39;port&#39;]=80;		}
    $httpheader = "POST " . $url_info[&#39;path&#39;] . " HTTP/1.0\r\n";
    $httpheader.= "Host:" . $url_info[&#39;host&#39;] . "\r\n";
    $httpheader.= "Content-Type:application/x-www-form-urlencoded\r\n";
    $httpheader.= "Content-Length:" . strlen($post_data) . "\r\n";
    $httpheader.= "Connection:close\r\n\r\n";
    $httpheader.= $post_data;
    $fd = fsockopen($url_info[&#39;host&#39;], $url_info[&#39;port&#39;]);
    fwrite($fd, $httpheader);
    $gets = "";	$headerFlag = true;	while (!feof($fd)) {		if (($header = @fgets($fd)) && ($header == "\r\n" || $header == "\n")) {			break;		}	}
    while (!feof($fd)) {		$gets.= fread($fd, 128);
    }
    fclose($fd);  
    
    return $gets;
}


/**
 * 电商Sign签名生成
 * @param data 内容   
 * @param appkey Appkey
 * @return DataSign签名
 */
function encrypt($data, $appkey) {
    return urlencode(base64_encode(md5($data.$appkey)));
}


?>

ログイン後にコピー

他のAPIインターフェースについては、 Express Bird にアクセスしてください。詳細については、関連ドキュメントを参照してください。