商品导入接口规范

《商品导入接口规范》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、商品导入接口规范1.调用入口不同的协议采用不同的调用入口，具体如下：协议调用入口SOAPhttp://fxt.freep.cn/api/Gateway.svc/soapHTTPhttp://fxt.freep.cn/api/Gateway.svc/http如果需要创建SOAP客户端，可以从以下地址获取服务元数据（遵循WSDL标准）：http://fxt.freep.cn/api/Gateway.svc?wsdl。2.操作调用本接口包含身份验证（Authenticate）和导入商品（ImportGoo

2、ds）两个操作，每一个操作都有一个唯一的名称，其调用地址为：调用入口+路径分隔符+操作名，例如身份认证操作的调用入口为：http://fxt.freep.cn/api/Gateway.svc/soap/Login（SOAP）http://fxt.freep.cn/api/Gateway.svc/http/Login（HTTP）3.操作参数（1）不同的操作有不同的参数，详见《商品导入接口操作说明》。（2）所有参数都需要序列化，序列化规则参见本文档中的“序列化规则”一节。（3）参数中包含中文字符时需要编

3、码，编码标准采用utf-8。（4）采用HTTP协议时，所有参数均以POST方法提交，并封装于请求正文。（5）调用导入商品操作时需要携带Cookie身份凭证，此身份凭证由身份验证操作颁发，由调用方负责保存。4.操作返回值（1）各操作的返回值参见《商品导入接口操作说明》。（2）返回值已序列化，序列化规则见本文档中的“序列化规则”一节。（3）返回值中如果包含中文字符，采用utf-8标准进行编码。（4）服务端执行操作失败将向调用方发送错误信息，错误信息数据结构的名称为BusinessFault，其序列化规则

4、请参见本文档中的“序列化规则”一节。（5）采用HTTP协议时，不论服务端执行成功还是失败返回的Http状态码均为200，如果执行成功则在响应消息正文中包含返回值（已序列化），如果执行失败则在响应消息正文中包含错误信息（已序列化）。9/91.序列化规则使用SOAP协议调用接口时，仅支持XML序列化方案。如果使用HTTPREST协议调用接口，则可以自主指定XML或JSON序列化方案，指定方式为在HTTP请求头中设置“Content-Type:application/xml”或“Content-Type:

5、application/json”。（1）请求数据的序列化XML序列化：<操作名xmlns="http://data.888027.com"><简单参数名>参数值<复杂参数名xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><属性名>属性值<属性名>属性值<集合参数名xmlns:i="htt

6、p://www.w3.org/2001/XMLSchema-instance"><元素类型名><元素类型名>请求数据XML序列化示例：

7、erson>22湖北省80false沙洋中学GaoZhong男

8、rson>9/923湖北省60false襄樊一中GaoZhong男