Express Bird クエリ API インターフェイスの使用法 (PHP バージョン)

この記事では、主に Express Bird Query API インターフェース (PHP バージョン) の使用方法を紹介します。必要な友人に共有します。

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

Express Bird

Express 100

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

   
   

   Express Bird
、API インターフェースのリクエストは

無制限

、

永久に無料です

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

注文の物流情報をクエリ

---

達成可能なニーズ

アプリはエクスプレス物流情報クエリAPIインターフェイスを実装するために直接統合されています

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

1. など

2. Apply Key

3. 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 にアクセスしてください。詳細については、関連ドキュメントを参照してください。

注意事項

あなたの製品をExpressインターフェースにドッキングまたは統合する必要がある場合は、Express Birdが良い選択です。問い合わせの数に制限はありません。そしてそれはいつでも無料です。

以上がExpress Bird クエリ API インターフェイスの使用法 (PHP バージョン)の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。