商品导入接口规范方案.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/AgeProvince湖北省/ProvinceSchools!—Person类的Schools属性，为集合类型--SchoolAge80/AgeIsGoodfalse/IsGood!--bool类型--Name沙洋中学/NameTypeGaoZhong/Type!--枚举类型--/School/SchoolsSex男/Sex/PersonPerson!--集合中的第二个元素--Age23/AgeProvince湖北省/ProvinceSchoolsSchoolAge60/AgeIsGoodfalse/IsGoodName襄樊一中/NameTypeGaoZhong/Type/School/SchoolsSex男/Sex/Person /persons school xmlns:i/2001/XMLSchema-instance !--复杂参数：school--Age90/AgeIsGoodtrue/IsGoodName湖北大学/NameTypeDaXue/Type /school joinTime2014-09-0/joinTime !--简单参数-- /JoinSchool JSON序列化：“简单参数名”：”简单参数值”， !--对于枚举类型，用枚举值-- “复杂参数名”： “属性名1”:”属性值1”, !--对于枚举类型，用枚举值-- “属性名”:”属性值” !--更多属性--, “集合参数名”：[ !—集合中的第一个对象-- “属性名1”:”属性值1”, “属性名2”:”属性值2” !--更多属性--, !—集合中的第二个对象-- “属性名1”:”属性值1”, “属性名1”:”属性值2” !--更多属性--!--更多对象-- ]persons:[!—集合参数：persons--!—集合中的第一个对象-- Age:10, Province:湖北省, Schools:[ !—Person类的Schools属性，为集合类型-- Age:70, IsGood:false, !—bool类型-- Name:沙洋中学, Type:0!—枚举类型，使用枚举值-- ], Sex:男 ,!—集合中的第二个对象-- Age:23, Province:湖北省, Schools:[ Age:70, IsGood:false, Name:襄樊一中, Type:0 ], Sex:男” ], school:!—复杂参数：school-- Age:90, IsGood:true, Name:湖北大学, Type:2 , joinTime:2014-09-03 !—简单参数：joinTime--返回值的序列化 XML序列化： !--基元类型返回值-- 操作名Response xmlns 操作名Result返回值/操作名Result!--对于枚举