商品导入接口范.docVIP

商品导入接口规范 调用入口 不同的协议采用不同的调用入口，具体如下： 协议 调用入口 SOAP /api/Gateway.svc/soap HTTP /api/Gateway.svc/http 如果需要创建SOAP客户端，可以从以下地址获取服务元数据（遵循WSDL标准）：/api/Gateway.svc?wsdl。 操作调用 本接口包含身份验证（Authenticate）和导入商品（ImportGoods）两个操作，每一个操作都有一个唯一的名称，其调用地址为：调用入口 + 路径分隔符 + 操作名，例如身份认证操作的调用入口为： http:// /api/Gateway.svc/soap/Login（SOAP） http:// /api/Gateway.svc/http/Login（HTTP） 操作参数 不同的操作有不同的参数，详见《商品导入接口操作说明》。 所有参数都需要序列化，序列化规则参见本文档中的“序列化规则”一节。 参数中包含中文字符时需要编码，编码标准采用utf-8。 采用HTTP协议时，所有参数均以POST方法提交，并封装于请求正文。 调用导入商品操作时需要携带Cookie身份凭证，此身份凭证由身份验证操作颁发，由调用方负责保存。 操作返回值 各操作的返回值参见《商品导入接口操作说明》。 返回值已序列化，序列化规则见本文档中的“序列化规则”一节。 返回值中如果包含中文字符，采用utf-8标准进行编码。 服务端执行操作失败将向调用方发送错误信息，错误信息数据结构的名称为BusinessFault，其序列化规则请参见本文档中的“序列化规则”一节。 采用HTTP协议时，不论服务端执行成功还是失败返回的Http状态码均为200，如果执行成功则在响应消息正文中包含返回值（已序列化），如果执行失败则在响应消息正文中包含错误信息（已序列化）。 序列化规则 使用SOAP协议调用接口时，仅支持XML序列化方案。如果使用HTTP REST协议调用接口，则可以自主指定XML或JSON序列化方案，指定方式为在HTTP请求头中设置“Content-Type: application/xml”或“Content-Type: application/json”。 请求数据的序列化 XML序列化： 操作名 xmlns= 简单参数名参数值/简单参数名 !--对于枚举类型，用枚举项名称-- 复杂参数名 xmlns:i=/2001/XMLSchema-instance 属性名属性值/属性名 !--对于枚举类型，用枚举项名称-- 属性名属性值/属性名 !--更多属性-- /复杂参数名 集合参数名 xmlns:i=/2001/XMLSchema-instance 元素类型名/元素类型名 元素类型名/元素类型名 !--更多元素-- /集合参数名 /操作名 请求数据XML序列化示例： JoinSchool xmlns= !--操作名：JoinSchool-- persons xmlns:i=/2001/XMLSchema-instance !--集合参数：persons-- Person !--集合中的第一个元素-- Age22/Age Province湖北省/Province Schools !—Person类的Schools属性，为集合类型-- School Age80/Age IsGoodfalse/IsGood !--bool类型-- Name沙洋中学/Name TypeGaoZhong/Type !--枚举类型，使用枚举项值-- /School /Schools Sex男/Sex /Person Person !--集合中的第二个元素-- Age23/Age Province湖北省/Province Schools School Age60/Age IsGoodfalse/IsGood Name襄樊一中/Name TypeGaoZhong/Type /Sc