商品导入接口规范.doc

商品导入接口规范 调用入口 不同的协议采用不同的调用入口，具体如下： 协议 调用入口 SOAP /api/Gateway.svc/soap HTTP /api/Gateway.svc/http 如果需要创建SOAP客户端，可以从以下地址获取服务元数据（遵循WSDL标准）：/api/Gateway.svc?wsdl。 操作调用 本接口包含身份验证（Authenticate）和导入商品（ImportGoods）两个操作，每一个操作都有一个唯一的名称，其调用地址为：调用入口 + 路径分隔符 + 操作名，例如身份认证操作的调用入口为： http:// /api/Gateway.svc/soap/Login（SOAPhttp:// /api/Gateway.svc/http/Login（HTTPContent-Type: application/xml”或“Content-Type: application/json”。 请求数据的序列化 XML序列化： 操作名 xmlns= 简单参数名参数值/简单参数名 !--对于枚举类型，用枚举项名称-- 复杂参数名 xmlns:i=/2001/XMLSchema-instance 属性名属性值/属性名 !--对于枚举类型，用枚举项名称-- 属性名属性值/属性名 !--更多属性-- /复杂参数名 集合参数名 xmlns:i=/2001/XMLSchema-instance 元素类型名/元素类型名 元素类型名/元素类型名 !--更多元素-- /集合参数名 /操作名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 /School /Schools Sex男/Sex /Person /persons school xmlns:i=/2001/XMLSchema-instance !--复杂参数：school-- Age90/Age IsGoodtrue/IsGood Name湖北大学/Name TypeDaXue/Type /school joinTime2014-09-0/joinTime !--简单参数-- /JoinSchool JSON序列化： { “简单参数名”：”简单参数值”， !--对于枚举类型，用枚举值-- “复杂参数名”：{ “属性名1”:”属性值1”, !--对于枚举类型，用枚举值-- “属性名”:”属性值” !--更多属性-- }, “集合参数名”：[ { !—集合中的第一个对象-- “属性名1”:”属性值1”, “属性名2”:”属性值2” !--更多属性-- }, {!—集合中的第二个对象-- “属性名1”:”属性值1”, “属性名1”:”属性值2” !--更多属性-- } !--更多对象-- ] } { persons:[ !—集合参数：persons--