Magento Weicot Json Api 文档 可用于 Java 和 JavaScript 等

WEICOT JSON JAVA JAVASCRIPT 通用 API 插件 本网站有售

/**
 * Mageto Api Json
 * User: ajiang
 * WebSite: WWW.WEICOT.COM
 * Date: 2016/6/21 0021
 * Time: 09:00 v0.23
 */

购买此接口
我将提供
安卓 Java Json 或 Soap 解析器源码 以及相应模块
WEB JavaScript Json 解析器 及模块源码

API 基本流程

获取产品 流程
1.获得目录
2.获得产品列表
3.获得产品信息
4.筛选产品

注册-支付 流程
1.注册 / 登陆
2.更新地址
3.创建订单
4.付款
5.更新订单
订单流程结束

本接口直接调用内部函数效率 比较高 可以缓存

接口 规范

请求结构： 以产品列表为例

http://weicot.com/weicot/api?session=xxxxxxxx&action=productlist&catalogid=4&page=1

 返回结构：
 统一返回json

  格式：
  id=sdf*fD4fsf$$Df4aD*!%cvsvewt%6Ddff         通用授权码 app授权id由服务器端设置  只用授权一次 就可获得session
  session=xxxxxxxx  会话 由客户端设置  每个客户端唯一的识别码
  action=cataloglist  所要执行的模块

V1 接口： 不兼容V2

 action=cataloglist  所要执行的模块

 这里 cataloglist[方法名] == 方法名

action 已有的模块：
  - cataloglist   //目录列表
  - productlist   //产品列表
  - productinfo   //产品信息
  - filter        //属性筛选
 ...

V2 接口： 兼容V1

action=catalog.list 

这里 catalog[模块名].list[方法名] ==模块名.方法名

action 已有的模块：
  - catalog.list   //目录列表
  - product.list   //产品列表
  - product.info   //产品信息
  - filter.filter        //属性筛选
 ...

以V1 和其函数为例 数据未经加密

明文传输 有被拦截的封风险
建议 对数据加密后传输

产品

http://test/weicot/api？?正式接口
http://test/weicot/ap 测试 接口

1.获得产品目录

请求数据

返回数据

{
  "catalog":[
    {
      "rootCatalogId":"4", //目录ID
      "rootCatalogName":"全部车型" //Title
    },
    . . .
    {
      "rootCatalogId":"432",
      "rootCatalogName":"汽车金融"
    }
  ],
  "childCatalog":[
    {
      "childCatalogId":"9",
      "childCatalogName":"别克"
    },
    {
      "childCatalogId":"10",
      "childCatalogName":"大众"
    },
    {
      "childCatalogId":"11",
      "childCatalogName":"本田"
    },
 ?. . .
    {
      "childCatalogId":"435",
      "childCatalogName":"3"
    }
  ]
}

2.获得产品列表

请求数据

返回数据

{
  "products":[
    {
      "uid":"508",
//产品ID
      "title":"上汽大众 朗行 ",
      "href":"http://www.test/dz7-5.html"
//产品链接,
      "imgPath":"http://www.test/media/catalog/product/cache/1/thumbnail/9df78eab33525d08d6e5fb8d27136e95/d/z/dz7-11_4.jpg",
//主图
      "remark":"￥?11.29万",
//价格
      "special_price":"￥?11.29万",
//特价
      "subTitle":"<span class="chenxingrong"><b>赠</b>：贴膜 脚垫 挡泥板 行车记录仪</span>"
//短描述
    },
...
    {
      "uid":"545",
      "title":"上汽大众 帕萨特",
      "href":"http://www.test/dz11-a1.html",
      "imgPath":"http://www.test/media/catalog/product/cache/1/thumbnail/9df78eab33525d08d6e5fb8d27136e95/d/z/dz11-11.jpg",
      "remark":"￥?18.39万",
      "special_price":"￥?18.39万",
      "subTitle":"<span class="chenxingrong"><b>赠</b>：贴膜 脚垫 挡泥板 行车记录仪</span>"
    }

  ]
}

3.获得产品详情

请求数据

返回数据
{
  "id":"508", //产品ID
  "name":"上汽大众 朗行 ~2015款 1.6L 手动 风尚版",
  "short_description":"<span class="chenxingrong"><b>赠</b>：贴膜 脚垫 挡泥板 行车记录仪</span>", //短描述
  "description":"<p><img alt="" src="http://www.test/media/wysiwyg/dz7-1.jpg" /><img alt="" src="http://www.test/media/wysiwyg/dz7-2.png" /><img alt="" src="http://www.test/media/wysiwyg/dz7-3.png" /><img alt="" src="http://www.test/media/wysiwyg/dz7-4.jpg" /><img alt="" src="http://www.test/media/wysiwyg/dz7-5.png" /><img alt="" src="http://www.test/media/wysiwyg/dz7-6.jpg" /><img alt="" src="http://www.test/media/wysiwyg/dz7-7.jpg" /><img alt="" src="http://www.test/media/wysiwyg/dz7-8.jpg" /><img alt="" src="http://www.test/media/wysiwyg/dz7-9.jpg" /><img alt="" src="http://www.test/media/wysiwyg/dz7-10.jpg" /></p>"", //描述
  "attributes":[ //属性
    {
      "label":"年款",
      "value":"2015款"
    },
    {
      "label":"国别",
      "value":"合资"
    },
    {
      "label":"厂商",
      "value":"上汽大众"
    },
    {
      "label":"级别",
      "value":"紧凑型"
    },
...
    {
      "label":"座椅材质",
      "value":"织物"
    }
  ],
  "option":[ //选项
    {
      "option_id":"1470", //选项子id
      "title":"全款",
      "id":"460" //选项主ID
    },
    {
      "option_id":"1471",
      "title":"置换",
      "id":"460"
    },
    {
      "option_id":"1472",
      "title":"贷款",
      "id":"460"
    }
  ],
  "price":"112900.0000", //价格
  "special_price":112900, //特价
  "image":[//小图
    {
      "image":"http://www.test/media/catalog/product/d/z/dz7-11_4.jpg"
    },
    {
      "image":"http://www.test/media/catalog/product/d/z/dz7-12_2.jpg"
    }
  ],
  "model":"dz7-1", //SKU
  "rating":0,
  "shipping":"0",
  "related_product":{ //相关产品
    "2015款":[
      {
        "title":"1.6L 自动 风尚版", //产品名
        "value":"1254" //产品ID
      },
      {
        "title":"1.6L 手动 舒适版",
        "value":"1255"
      },
      ...
      {
        "title":"1.6L 手动 风尚版",
        "value":"508"
      }
    ]
  },
  "in_stock":1 //是否有货
}

4.筛选

注册及结账流程

1.登录接口

请求数据

返回数据

{
  "status":"OK",
  "userData":"58",
  "addressData":{
    "Addresses":[
      {
        "addressId":"47",
        "name":"vbfdxvsdvsdv ",
        "company":null,
        "zip":"361000",
        "region":"江西省",
        "city":"厦门",
        "district":null,
        "street":"fdgadfg",
        "telephone":"13606027732",
        "fax":null,
        "country":"CN",
        "is_default":"1" //是否默认地址 1 是 0 不是
      }，
      {
        "addressId":"81",
        "name":"xxxx12 ",
        "company":null,
        "zip":"100010",
        "region":"天津市",
        "city":"和平区",
        "district":"劝业场街道",
        "street":"劝业场街道",
        "telephone":"13602585958",
        "fax":null,
        "country":"CN",
        "is_default":"0"
      },
      {
        "addressId":"82",
        "name":"vxcc ",
        "company":null,
        "zip":"100010",
        "region":"天津市",
        "city":"和平区",
        "district":"体育馆街道",
        "street":"体育馆街道",
        "telephone":"13606028565",
        "fax":null,
        "country":"CN",
        "is_default":"0"
      }
    ]
  }
}

2.添加到购物车

请求数据

返回数据

{
  "status":"1",
  "message":"add true"
}

备注 :

产品详情页 中的选项
“option”:[
{
“option_id”:”315″, //子选项ID?optiontype
“title”:”全款”
“id”:”75″ //选项ID?optionid
},

3.注册

备注

注册 之后的地址不是默认地址
更新 后的地址是默认地址

请求数据

返回数据

0.10 旧接口
{
  "status":"true", 如果 注册信息错误 则返回 false
  "customerId":"93", //顾客ID
  "name":"pppppo",
  "email":"we@wet.com",
  "tel":"10086"
}
0.11 新接口
{
  "status":"true",
  "customerId":"108",
  "name":"pppppo",
  "email":"we@dwessst.com",
  "tel":"10086",
  "addressId":"142" //增加地址Id 用于更新地址
}
 

错误信息 示范

{
  "status":"false",
  "message":"user_exist"
}

4.更新地址

备注:

使用 此接口的地址将会成为默认收货地址

请求数据

返回数据

{
  "state":"true", //状态 true 为添加成功 false 为失败
  "addressID":"98" //地址ID
}

备注:

在地址簿中显示的数据

{
        "addressId":"98", /可以有顾客信息 获得
        "name":"老王 ",
        "company":null,
        "zip":"10086",
        "region":"北京市", / 省市区 三级接口
        "city":"东城区",
        "district":"东华门街道",
        "street":"sm广场",
        "telephone":"13502523651",
        "fax":null,
        "country":"CN",
        "is_default":"1" /是否是默认地址
      },

备注：

地址接口 数据为静态数据 建议做java 储存到本地

省
请求地址?

"2":{
      "code":"2", `地址 ID
      "name":"西城区"
    },

市
请求地址

{
  "485":{
    "1":{
      "code":"1",
      "name":"东城区"
    },
    "2":{
      "code":"2",
      "name":"西城区"
    },

区
请求地址?

5.创建订单 接口

请求数据

返回数据

{
  "state":"true", 状态 错误为false
  "orderID":"100000173" 订单号
}

6.使用服务器端 进行支付

请求地址

返回数据
返回服务器端的成功页面 不建议使用服务器端支付 因为捕捉订单状态是个麻烦事儿

7.更改订单状态

请求地址

返回数据

  
{
  "state":"true",
  "orderID":"100000173"
}

参考及引用
Magento REST API
Mageto Soap Api
Debugging Magento API Method Calls
PHP 安装 Oauth 扩展

转载请注明：(●--●) Hello.My Weicot » Magento Weicot Json Api 文档 可用于 Java 和 JavaScript 等