ShopXO商城二次开发开放接口提供与ERP对接订单查询,物流同步的API接口

前几天有人找我对接ShopXO,查了一下官方文档,发现 有API控制器,但是没有对外开放的接口,看了一下发现实现起来非常简单,本人对php不了解,只是依样画葫芦随手做了一个。

 

使用方法:

将文件上传至ShopXO网站根目录下的/app/api/controller/OpenApi.php

API的接口地址:http://xxx.xxx.com/api.php?s=OpenApi/{ApiType}

 

根据客户的需要,主要开放了以下几个接口

1.获取订单列表

     * [List 获取订单列表]
     * 接口地址:http://xxx.xxx.com/api.php?s=OpenApi/OrderList
     * request  post
     * 
     * page:1           #页号 1开始
     * page_size:20     #分页大小
     * status:2		    #2 待发货
     * pay_status:1     #1 已付款
     * upt_time_start   #更新时间开始 传时间字符串 yyyy-MM-dd HH:mm:ss
     * upd_time_end     #更新时间结束 传时间字符串 yyyy-MM-dd HH:mm:ss

  

 

2.获取订单详情

     * [Detail 获取详情]
     * 接口地址:http://xxx.xxx.com/api.php?s=OpenApi/OrderDetail
     * request  post
     * 
     * order_no                     #订单编号   *

  

3.订单物流发货 

     * 订单发货
     * 接口地址:http://xxx.xxx.com/api.php?s=OpenApi/OrderDelivery
     * @request   post 
     * order_no                                 #订单号         * 1
     * express_id:2                             #快递公司ID
     * express_number:222222222                 #快递单号
     * 
     * @response
     * {
     *      "msg": "状态不可操作[待收货]",      #发货成功
     *      "code": -1,                         #成功 0  失败 -1
     *      "data": ""
     * } 

  

4.获取快递公司列表

     * @request   post 
     * 接口地址:http://xxx.xxx.com/api.php?s=OpenApi/ExpressList

   

5.用户昵称获取

     * @request   post 
     * 接口地址:http://xxx.xxx.com/api.php?s=OpenApi/UserNick
     * id:1                                     #用户ID    

   

6.修改商品库存、名称、价格、保质期(自定义)信息

     * request  post
     * 接口地址:http://xxx.xxx.com/api.php?s=OpenApi/GoodsSave
     * coding:管家编码                  #管家货品编码(必须)唯一匹配条件
     * title:测试测试修改标题           #修改的商品名称         *
     * price:88.88                      #修改的商品规格价格     *
     * exp:2023-11-10                   #修改的商品保质期       *

    

数据传输安全因为客户自己内部使用,而且客户是ssl,接口安全性要求不高,所以只做了一个secretkey来进行验证。

自己使用一定要记得更换这个secretkey !

        //  +----------------------------------------------------------------------
        //  |      接口传输安全密钥,请勿泄露,否则将可能导致安全隐患             |
        //  +----------------------------------------------------------------------
        $secretkey = '2drRqakg6hawXDG4vKwJXBNohawXD4tvKnQYoaYC58V5BwGBXMA0gRA9qSPN7Z';            

  

只需要每次访问的时候FormData中加上就行

  

当然,如果外网使用还是用Signature签名方法安全性更高。

Signature签名方法我已经附在了源码结尾,有能力的自己修改一下即可,也可以联系QQ3592030

 

提供源文件:

链接: https://pan.baidu.com/s/1RPNQ3thO-9NfgKrjXxIu8w 提取码: faa5

 

posted @ 2021-10-30 08:44  西安小柯  阅读(1143)  评论(0编辑  收藏  举报