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' -- 订阅消息接收路由