《八百方网站商家数据接口规范.v.2.0(1)》由会员分享，可在线阅读，更多相关《八百方网站商家数据接口规范.v.2.0(1)（11页珍藏版）》请在金锄头文库上搜索。
1、 八百方网站数据接口规范 1 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 753号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-37886982密级普通急度普通八 百 方 网 站数 据 接 口 规 范版本：2.0编写时间：2012 年 03 月 21 日编写：八百方技术部 八百方网站数据接口规范 2 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 753号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-37886982第一章 文档描述1. 文档说明1) 本操作手册用来指导八百方商家实现与八
2、百方商品数据同步。请相关技术人员详细阅读本手册。2) 1、2 中 红色标记的文字内容表示需要在以前的基础上补充的功能， “商家商品与八百方商品同步”是需要新加的功能。2. 阅读对象商家开发人员八百方相关技术人员3. 接口联系人职责 业务支持姓名 徐春映 电话 020-37886791Email QQ 1725857815职责 技术支持姓名 郭景宇 电话 020-37886986-833Email QQ 641288940第二章 业务功能描述 八百方网站数据接口规范 3 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 753号天誉商务大厦东塔 2503室Tel: 020-37886
3、992 / Fax: 020-378869821. 库存、价格、上下架状态及时查询流程简述1) 八百方系统向商家系统发送对某商品库存、价格、上下架状态查询的请求。2) 商家系统接收请求后将查询到的库存、价格、上下架状态返回给八百方系统。3) 八百方系统接收到返回的库存、价格、上下架状态后对库存进行判断并进行客户是否可以下单的处理。2. 商品价格、库存、上下架状态更新流程简述 八百方网站数据接口规范 4 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 753号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-378869821) 八百方系统向八百方
4、商家系统发送商品价格、库存、上下架状态更新查询请求。2) 商家系统接收八百方查询请求后将查询到的价格、库存、上下架状态返回给八百方平台。3) 八百方平台接收返回的价格、库存、上下架状态数据并更新商品库。3. 商家商品与八百方商品自动同步流程简述1) 商家系统商品数据发生变更，商家系统向八百方接口地址发送数据同步请求。2) 八百方系统接收数据同步请求进行有效性验证，验证失败则返回错误代码给商家，验证成功则更新八百方系统数据然后返回成功与失败的代码给商家系统。3) 商家系统接受八百方系统返回的代码做相应的处理。 八百方网站数据接口规范 5 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路
5、 753号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-378869824. 接口规范及安全控制1) 所有数据接口均以互联网超文本传送协议（即 HTTP 协议）为规范标准执行，必须支持 GET 或 POST 请求方式。2) 交互的数据同时传递明文字符串及密文字符串，以 MD5 加密算法标准作为数字签名安全规范，保证交互的数据安全。双方应协商好加密的私钥，以保证数字签名的有效验证。第三章 接口协议1. 库存及时查询接口协议1) 接入 urlhttp:/(可访问 Stocks 网址)?productCode= XXXXX&signtype=md5&sign=
6、XXXXXX2) 接入方式GET/POST 方式3) 协议参数变量名 含义 类型 可未空 说明productCode 商品编码 String 否商家自身系统的商品编码，此编码需提前提供给八百方匹配好相应商品。signtype 加密类型 String 否 目前仅支持 MD5加密算法。sign 加密字符串 String(32) 否加密后的密文字符串，加密数据=MD5(商品编码+私钥)。 八百方网站数据接口规范 6 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 753号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-37886982说明：a) 八百
7、方合作商家返回指定商品的库存、价格、上下架状态数据。b) 内容格式要求：XML 格式注意：当出现查询错误时属性 is_fail 的值应该为 T。2. 商品价格及库存更新1) 接入 urlhttp:/(可访问 PriceStocks 网址 )?productCode=xxxx &signtype=md5&sign=XXXXXX2) 接入方式GET/POST 方式3) 协议参数变量名 含义 类型 可未空 说明productCode 商品编码 String 否 商家自身系统的Fxxxxxx123413.0012.001 八百方网站数据接口规范 7 / 11 广州市八百方信息技术有限公司广州市越秀区东
8、风东路 753号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-37886982商品编码，此编码需提前提供给八百方匹配好相应商品。当有多个产品更新时以英文逗号“,” 作分割符连接多个商品编码。signtype 加密类型 String 否 目前仅支持 MD5加密算法。sign 加密字符串 String(32) 否加密后的密文字符串，加密数据=MD5(商品编码+私钥)。说明：a) 八百方合作商家返回指定商品的库存、价格、上下架状态数据。b) 内容格式要求：XML 格式 八百方网站数据接口规范 8 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 75
9、3号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-37886982注意：当出现查询错误时属性 is_fail 的值应该为 T。3. 商家商品与八百方商品自动同步1) 接入 urlhttp:/ 接入方式GET/POST 方式3) 协议参数a) 八百方合作商家构造 url 参数说明变量名 含义 类型 可为空 说明shopcode 商家编码 String 否 商家在八百方系统的Fxxxxxxx220135.20135.201 八百方网站数据接口规范 9 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 753号天誉商务大厦东塔 2503室Tel:
10、020-37886992 / Fax: 020-37886982商家编码productcode商家商品编码String 否storage 库存 int 否price 商城价 double 否 精确到小数点后两位marketprice 市场价 double 否 精确到小数点后两位alive 上下架 int 否 上架：1，下架：0datetime 当前时间 string 否yyyyMMdd hh:mm:ss(24 小时制)sign加密字符串string(32) 否加密后的密文字符串，加密数据=MD5(shopcode=xx&productcode=xx&storage=xx&price=xx&ma
11、rketprice=xx&alive=xx&datetime=xx&signkey=xx)私钥(signkey )：由八百方提供给商家returnurl商家回调地址否 由商家提供b) 八百方返回参数说明变量名 含义 类型 可为空 说明shopcode 商家编码 string 否商家在八百方系统的商家编码 八百方网站数据接口规范 10 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 753号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-37886982productcode商家商品编码string 否storage 库存 int 否price
12、商城价 double 否 精确到小数点后两位marketprice 市场价 double 否 精确到小数点后两位alive 上下架 int 否 上架：1，下架：0datetime 当前时间 string 否yyyyMMdd hh:mm:ss(24 小时制)sign加密字符串string(32) 否加密后的密文字符串，加密数据=MD5( shopcode=xx&productcode=xx&storage=xx&price=xx&marketprice=xx&alive=xx&datetime=xx&signkey=xx)私钥(signkey )：由八百方提供给商家statecode 状态编码 int 否同步失败：0同步成功：1商家编码错误：2商家商品编码错误：3库存格式错误：4商城价格式错误：5市场价格式错误：6 八百方网站数据接口规范 11 / 11 广州市八百方信息技术有限公司广州市越秀区东风东路 753号天誉商务大厦东塔 2503室Tel: 020-37886992 / Fax: 020-37886982上下架格式错误：7验证信息错误：8statedes 状态描述 String 否 返回状态的描述信息备注：除使用 java 语言编写的系统外，其他语言编写的系统暂不做加密验证
