1. 程式人生 > >PHP對接1688跨境鋪貨功能sdk使用說明

PHP對接1688跨境鋪貨功能sdk使用說明

檔案說明

  • /app/Component/Ali/Sdk -- sdk資料夾
  • /app/Component/Ali/AliApi.php -- 1688各介面封裝類
  • /app/Component/Ali/TransferController.php -- 1688各介面回撥控制器
  • /routes/api.php -- 路由檔案

1) AliApi.php

呼叫方法

例項化 AliApi 時需要傳入引數 , 引數就是將要呼叫介面的名稱,new AliApi('ProductInfo') .

引數列表

  • ProductInfo -- 跨境場景獲取商品詳情
  • ProductList -- 跨境場景獲取商品列表
  • ProductListPushed -- 跨境場景下將商品加入鋪貨列表
  • ProductListPushed -- 同步鋪貨結果
  • SubaccountAuthAdd -- 批量新增子賬號授權
  • SubaccountAuthCancel -- 批量取消子賬號授權
  • SubaccountAuthList -- 批量查詢子賬號授權

返回引數

錯誤返回

{
    "info" : "error",
    "errorCode" : "gw.APIACLDecline",
    "errorMessage" : "您的AppKey暫無許可權呼叫當前API"
}

正確返回

其他方法

1.function getRefreshToken($redirect_url){}

code

換取RefreshToken,在執行此函式之前需要先執行授權得到code , 此方法已封裝好 , 在new AliApi()的時候已經自動呼叫 , 並存入Cache 中 . 在有code的情況下直接執行此函式可以獲取最新的refreshToken . 返回值 :

'1066e1d1-0ed5-4d6c-8f1e-042e49a6f4b1'

2.function getAndSaveAppCode($redirect_url) 直接執行此函式返回商戶授權頁面連結 返回值 :

https://auth.1688.com/oauth/authorize?client_id=51231&site=1688&redirect_uri=http://example.com'

2) TransferController.php

  • function test(){}

     public function test () 
     {
         $ali = new AliApi('ProductPushResult'); //傳入引數名,例項化介面類
         if($ali->auth == false){
             return $this->authorize ();
         }  //這一段寫,判斷是否授權,有則直接執行,無則前往授權
         $a = $ali->productPushResultApi(['123456']); //呼叫介面函式
         return;
     }
  • function code(){} 授權頁面回撥控制器 , 授權後會跳轉該控制器地址 , 把code存入快取 , 有效期2分鐘 , 同時獲取refreshToken .
  • function authorize(){} 訪問此控制器重定向到授權頁面
  • function notify(){} 訊息訂閱 , 接收訂閱訊息控制器 , 具體請檢視此控制器

3) api.php

  • '1688/test' -- 介面呼叫模板路由
  • '1688/code' -- 授權回撥頁面路由
  • '1688/auth' -- 重定向至授權頁面路由
  • '1688/notify' -- 訂閱訊息接收路由