この記事では、主に Express Bird Query API インターフェース (PHP バージョン) の使用方法を紹介します。必要な友人に共有します。
プロジェクトは次のとおりです。開発中のニーズによっては、必然的に速達に関するいくつかの API インターフェースが使用されます。この記事では、主に速達のクエリ API と他の会社との違いを紹介します。
Express Bird
Express 100
-
Aicha Express
お待ちください- 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インターフェイスにクエリを実行して、自動クエリ機能を実現します
-
など
-
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 形式です |
|
アプリケーションレベルの入力パラメータ |
|
パラメータ名 |
タイプ |
必須
説明
| OrderCode |
varchar(50) | O |
注文番号 |
ShipperCode
| varchar(10) |
R |
Express会社コード |
|
LogisticCode
| 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('EBusinessID') or define('EBusinessID', '请到快递鸟官网申请http://kdniao.com/reg');
//电商加密私钥，快递鸟提供，注意保管，不要泄漏
defined('AppKey') or define('AppKey', '请到快递鸟官网申请http://kdniao.com/reg');
//请求url
defined('ReqURL') or define('ReqURL', 'http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx');
//调用查询物流轨迹
//---------------------------------------------
$logisticResult=getOrderTracesByJson();
echo logisticResult;
//---------------------------------------------
/**
* Json方式 查询订单物流轨迹
*/
function getOrderTracesByJson(){ $requestData= "{'OrderCode':'','ShipperCode':'YTO','LogisticCode':'12345678'}"; $datas = array(
'EBusinessID' => EBusinessID,
'RequestType' => '1002',
'RequestData' => urlencode($requestData) ,
'DataType' => '2',
);
$datas['DataSign'] = 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('%s=%s', $key, $value); } $post_data = implode('&', $temps);
$url_info = parse_url($url); if(empty($url_info['port'])) { $url_info['port']=80; }
$httpheader = "POST " . $url_info['path'] . " HTTP/1.0\r\n";
$httpheader.= "Host:" . $url_info['host'] . "\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['host'], $url_info['port']);
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 サイトの他の関連記事を参照してください。
![[Web フロントエンド] Node.js クイック スタート](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
