06苏州移动中小企业信息化平台接口规范-v16.docx

资源描述

苏州移动中小企业信息化平台接口标准版本履历版本号. 修订日期修订人审核人修改内容 V 2009-10-27 罗海平 V 2009-10-29 宋凯 1. .4 增加了参数 ParamMap。增加只有针对特殊产品才传入OrderCode的参数 2. 删除了原 ISV业务健康检查章节 3. 增加新的章节【产品业务期限查询接口】 2009-11-26 冯宇梁 1. 1.企业业务受理接口〔ISV10101〕增加只有针对特殊产品才传入OrderCode的参数目录 1 General Summary〔总体标准〕 2 1.1. 技术方案 2 1.2. 接口协议 2 1.2.1. 根本协议 2 1.2.2. 消息格式 2 1.3. 消息平安性 3 1.3.1. 数据平安 3 1.3.2. 加密算法 4 1.3.3. 密钥处理 4 1.3.4. 网络平安 5 2 Interface Specification〔接口描述〕 5 SaaS接口概述 5 SaaS管理平台提供ISV应用系统接口(ISV应用系统àSaaS管理平台) 7 SSO鉴权接口 7 SSO心跳接口 10 客户端登录接口 11 产品访问鉴权接口 13 企业信息接口 15 企业员工信息接口 17 企业部门信息接口 20 企业通讯录信息接口 23 ISV消息通知接口 25 ISV应用系统提供SaaS管理平台接口(SaaS管理平台àISV应用系统) 27 企业客户业务受理接口 27 企业客户员工业务受理接口 31 角色列表同步〔读取〕接口 34 用户角色权限同步〔读取〕接口 36 用户角色权限同步〔更新〕接口 38 产品业务期限查询接口 40 附录一：PDU通用HEAD〔消息头〕 1 附录二：数据类型 1 附录三：消息类型 1 附录四：算法说明 5 附录五：接口WSDL 6 General Summary〔总体标准〕 1.1. 技术方案本系统对外集成通信接口采用WebService技术作为SaaS平台与外部各系统之间的主要通信接口。 1.2. 接口协议 1.2.1. 根本协议双方的消息交互采用SOAP〔Simple Object Access Protocol，简单对象访问协议〕协议。 1.2.2. 消息格式所有的协议数据单元PDU(Protocol Data Unit)由如下表的消息头和消息体组成： PDU组成描述 Message Head 消息头 Message Body 消息体完整的消息格式如下例所示： <?xml version=〞1.0” encoding=〞UTF-8”?> <Msg> <Head> <Attribute1>消息头属性一</Attribute1> <Attribute2>消息头属性二</Attribute2> <Attribute3>消息头属性三</Attribute3> </Head> <Body>加密后的消息体</Body> </Msg> 其中未加密的消息体格式，如下例所示： <Attribute1>消息体属性一</Attribute1> <Attribute2>消息体属性二</Attribute2> <Attribute3>消息体属性三</Attribute3> 1.3. 消息平安性 1.3.1. 数据平安采用DES算法对数据进行加密。DES加密只针对消息体，对消息头不加密。不同的ISV应用系统采用不同的密钥对本系统向SaaS管理平台发送的消息进行加密。各个ISV应用系统的密钥由SaaS平台管理员在SaaS管理平台上设定新密钥的启用时间，SaaS系统自动生成新密钥；密钥生成后，SaaS平台管理员通过线下的方式给到ISV应用系统，ISV应用系统进行配置。SaaS和ISV应用系统在新密钥启用时间到来时同时启用新的密钥。 SaaS管理平台接收到ISV应用系统的消息后，根据消息头中的AppID获取对应ISV应用系统的密钥后，即可对消息体进行解密。 SaaS管理平台向ISV应用系统发送消息时，根据该应用系统对应的密钥对消息体进行加密。ISV应用系统接收到SaaS管理平台发送的消息后可直接采用自身的密钥对消息体解密。 <注>：对于特殊情况，ISV也可以选择不加密消息，直接传送明文。 1.3.2. 加密算法具体消息体的加密算法为：Base64(DES(MD5(消息体) + 消息体)) 1.3.3. 密钥处理对于Key,做如下处理： n Key与IV一致 n Key的长度为64bit n Key的格式为：ODD(MD5(Key)) u 对Key进行MD5 hash u 对hash值取奇数位子串经过上述处理的Key，再对消息体进行加密或解密。算法例如: public static string DESEncrypt(string data, string key) { if(String.IsNullOrEmpty(data) || string.IsNullOrEmpty(key)) { throw new ArgumentNullException("The param[s] cann't be null."); } DES des = DES.Create(); MD5 md5Hasher = MD5.Create(); byte[] keyHashBytes = md5Hasher.ComputeHash(Encoding.UTF8.GetBytes(key)); byte[] keyBytes = ArrayUtil<byte>.GetOddArray(keyHashBytes); byte[] ivBytes = ArrayUtil<byte>.GetOddArray(keyHashBytes);//IV is same as Key MemoryStream memoryStream = new MemoryStream(); CryptoStream cryptoStream = new CryptoStream(memoryStream, des.CreateEncryptor(keyBytes, ivBytes), CryptoStreamMode.Write); StreamWriter writer = new StreamWriter(cryptoStream); e(data); writer.Flush(); cryptoStream.FlushFinalBlock(); writer.Flush(); return Convert.ToBase64String(memoryStream.GetBuffer(),0,(int)memoryStream.Length); } 1.3.4. 网络平安 SaaS管理平台接口采用如下的手段保证和ISV应用系统之间通信的网络平安：IP鉴权及业务应用ID控制列表。 1. ISV应用系统接入SaaS管理平台时需提供其业务系统出访IP和URL〔根据其业务特性确定〕 2. SaaS管理平台为ISV应用系统的每一个业务分配一个全局唯一的业务应用ID 3. SaaS管理平台侧防火墙配置平安策略，只有有效的IP和业务应用ID才能访问SaaS管理平台 4. ISV应用系统端配置相应策略，以拒绝非SaaS管理平台的接口调用 Interface Specification〔接口描述〕 1.1 SaaS接口概述 SaaS接口提供两个webmethod的webservice供ISV调用：ResponseInfo SaaSISVInterface(RequestInfo req)和String SaaSISVInterfaceXMLString(String strXML)，两个方法的功能一样，只是参数和返回类型不同。ISV可以选择使用其中的一个方法来调用接口，具体的功能和返回信息由消息头的操作码：<Code>操作码</Code>决定，也就是说接口调用只有一个入口。反之，ISV提供应SaaS调用的接口也一样，只有一个入口，两个方法为：ResponseInfo ISVSaaSInterface(RequestInfo req)和String ISVSaaSInterfaceXMLString(String strXML)。<说明>：字符串实现接口时方法名称必须和本文档描述的一致〔ISVSaaSInterface 和ISVSaaSInterfaceXMLString〕。另外，平台还支持URL〔网页〕方式的接口，ISV可以直接向该一个URL地址POST数据，在返回流〔Response〕中就是满足接口标准接口的返回信息。具体的Request信息格式为：Msg＝“ XML文件的字符串〞，Response的格式就是本标准中描述的返回消息格式。 SaaS和ISV的应用系统可以看做是接口的两个相关人。他们各自需要提供接口供对方消费。 SaaS管理平应提供如下接口供ISV调用： l SSO鉴权接口 l SSO心跳接口 l 客户端登录接口 l 产品访问鉴权接口 l 企业信息接口 l 企业员工信息接口 l 企业部门信息接口 l 企业通讯录信息接口 l ISV消息通知接口 ISV应用系统应提供如下接口供SaaS调用： l 企业客户业务受理接口 l 企业客户员工业务受理接口 l 角色列表同步〔读取〕接口 l 用户角色权限同步〔读取〕接口 l 用户角色权限同步〔更新〕接口 1.2 SaaS管理平台提供ISV应用系统接口(ISV应用系统àSaaS管理平台) 1.2.1 SSO鉴权接口 1.2.1.1 接口描述用户使用ISV应用系统之前，首先需要登录SaaS管理平台。登录成功后，SaaS管理平台为用户生成平台访问身份认证Token〔令牌〕。用户在访问平台中各ISV应用系统时，各ISV应用系统将通过本接口对访问者进行统一的Token认证。以便对用户进行统一的SSO鉴权认证。 1.2.1.2 交互流程 1．用户先登录SaaS平台, 再从SaaS平台提供的入口访问ISV应用 a) 用户输入帐号和密码登录到SaaS管理平台，SaaS管理平台为用户产生Token。 b) 用户通过平台ISV产品链接或直接登录ISV应用系统，访问ISV应用系统。 c) ISV应用系统将用户Token发送到平台进行鉴权。 d) SaaS管理平台将鉴权结果结果信息返回ISV应用系统。 2．用户直接访问ISV的应用系统 a) 用户直接访问ISV应用系统。 b) ISV应用系统发现用户没有登录，将页面导向到SaaS平台的登录页面。 c) 用户输入帐号和密码登录到SaaS管理平台，SaaS管理平台为用户产生Token。 d) 用户通过平台ISV产品链接或直接登录ISV应用系统，访问ISV应用系统。 e) ISV应用系统将用户Token发送到平台进行鉴权。 f) SaaS管理平台将鉴权结果结果信息返回ISV应用系统。 1.2.1.3 应用场景 1．用户先登录SaaS平台,再从SaaS平台提供的入口访问ISV的应用系统 2．用户直接访问ISV的应用系统 1.2.1.4 接口定义消息类型编码 SYS10101 请求消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Request通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ISVID>应用提供商编号</ISVID> <AppID>应用〔产品〕编号</AppID> <Token>令牌</Token> 名称说明数据类型长度〔字节〕 ISVID 应用提供商编号 String 16 AppID 应用〔产品〕编号 String 16 Token 令牌〔可转换为Guid的串〕 String 36 返回消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Response通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ResultCode>返回结果代码</ResultCode> <ResultDesc>返回结果描述</ResultDesc> <CorpID>企业客户编号</CorpID> <UserID>用户ID</UserID> <UserType>用户类型</UserType> 名称说明数据类型长度〔字节〕 ResultCode 返回结果代码〔0: 有效Token；1: 无效Token〕 String 16 ResultDesc 返回结果文字描述 String 256 CorpID 企业客户编号 String 16 UserID 用户ID〔可转换成Guid类型〕 String 36 UserType 用户类型：(1: 企业管理员；0:企业普通用户) String 1 1.2.2 SSO心跳接口 1.2.2.1 接口描述为实现用户的单点登录，SaaS管理平台必须能够感知到用户当前是否处于存活状态。用户登录到ISV应用系统以后，SaaS管理平台无法确定用户是否在线，默认情况下，一定时间〔如30分钟〕后，SaaS管理平台将会自动杀死用户的进程。所以ISV应用系统必须定时调用该接口通知SaaS管理平台更新用户的存活期，以保证用户的Token在用户由ISV应用系统中返回到SaaS管理平台后仍然有效，可以继续访问其他ISV应用系统的功能。 1.2.2.2 交互流程 1．用户登录到ISV应用系统通过SaaS管理平台统一鉴权。 2． ISV应用系统定时〔30分钟内〕间隔一段时间后向SaaS管理平台发送心跳请求。 3． SaaS管理平台刷新用户Token存活期为初始值〔如30分钟〕。 4． SaaS管理平台发送心跳响应结果到ISV应用系统〔如Token不存在或刷新失败等。〕 1.2.2.3 应用场景 1.2.2.4 接口定义消息类型编码 SYS10102 请求消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Request通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <Token>令牌</Token> 名称说明数据类型长度〔字节〕 Token 令牌〔可转换为Guid的字符串〕 String 36 返回消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Response通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ResultCode>返回结果代码</ResultCode> <ResultDesc>返回结果描述</ResultDesc> 名称说明数据类型长度〔字节〕 ResultCode 返回结果代码〔0:成功；1:失败〕 String 16 ResultDesc 返回结果文字描述 String 256 1.2.3 客户端登录接口我们的效劳器和他们效劳器的接口 1.2.3.1 接口描述 ISV的智能客户端可以通过本接口进行客户端登录鉴权。 v 对于ISV的B/S架构应用应统一使用SaaS平台集成验证进行登录鉴权。 v 由于是C/S结构,可能会影响其余B/S应用的SSO登录体验 1.2.3.2 交互流程 1．用户在客户端输入用户名及密码。 2． ISV客户端将用户名，密码及其他系统配置信息通过接口发送到ISV效劳端 3． ISV效劳端通过Web Service调用SaaS平台的登录鉴权接口 4． SaaS平台效劳端将登录验证结果发回ISV效劳端 5． ISV效劳端将登录验证结果发回至客户端 1.2.3.3 应用场景 1.2.3.4 接口定义消息类型编码 SYS10201 请求消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Request通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ISVID>应用提供商编号 </ISVID> <AppID>应用系统编号</AppID> <Username>用户名</Username> <Password>密码</Password> 名称说明数据类型长度〔字节〕 ISVID 应用提供商编号 String 16 AppID 应用系统编号 String 16 Username 用户名 String 64 Password 密码 String 64 返回消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Response通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ResultCode>返回结果代码</ResultCode> <ResultDesc>返回结果描述</ResultDesc> <Token>令牌</Token> 名称说明数据类型长度〔字节〕 ResultCode 返回结果代码 (0: 有效用户帐号；1: 无效帐号或密码) String 16 ResultDesc 返回结果文字描述 String 256 Token 令牌(可转换为Guid的字符串) String 36 1.2.4 产品访问鉴权接口 1.2.4.1 接口描述在用户访问某一个ISV产品应用时，ISV可以通过调用本接口，对用户所在公司是否对产品具有访问权限〔用户所在公司是否已订购相应产品〕进行强制验证，从而保证用户对产品访问的平安检测。 v 此接口需配合SSO鉴权接口一起使用。 1.2.4.2 交互流程 1．用户访问某一个ISV应用产品。 2． ISV应用将登录鉴权时获得的用户Token及AppID发送至效劳端。 3． SaaS应用平台效劳端验证用户对产品的访问资格。 4． SaaS平台效劳端将验证结果发送回客户端。 1.2.4.3 应用场景 1.2.4.4 接口定义消息类型编码 SYS10202 请求消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Request通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <Token>令牌</Token> <AppID>应用ID</AppID> 名称说明数据类型长度〔字节〕 Token 令牌(可转换为Guid的串) String 36 AppID 应用(产品)编号 String 16 返回消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Response通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ResultCode>返回结果代码</ResultCode> <ResultDesc>返回结果描述</ResultDesc> 名称说明数据类型长度〔字节〕 ResultCode 返回结果代码〔0: 有产品权限；1: 无产品权限〕 String 16 ResultDesc 返回结果描述 String 256 1.2.5 企业信息接口 1.2.5.1 接口描述对于需要企业信息的ISV应用，那么实现该接口，以接受企业信息更新。 1.2.5.2 交互流程 1．管理员在平台中更新企业信息。 2． ISV定期〔按需〕从SaaS平台获取最新的企业信息。 3． SaaS平台将最新的企业信息返回至ISV。 4． ISV应用系统更新本地数据系统。 1.2.5.3 应用场景 1.2.5.4 接口定义消息类型编码 SYS10301 请求消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Request通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <CorpID>企业客户编号</CorpID> 名称说明数据类型长度〔字节〕 CorpID 企业客户编号 String 16 返回消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Response通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ResultCode>返回结果代码</ResultCode> <ResultDesc>返回结果描述</ResultDesc> <CorpID>企业客户编号</CorpID> <CorpName>企业客户名称</CorpName> <ShortName>企业客户简称</ShortName> <EnglishName>企业客户英文名称</EnglishName> <EngShortName>企业客户英文简称</EngShortName> <FQDN>企业FQDN</FQDN> <CorpLicense>企业营业执照号</CorpLicense> <LegalPerson>企业法人</LegalPerson> <AdminPhone>企业管理员联系 </AdminPhone> <AdminMobile>企业管理员联系 </AdminMobile> <AdminEmail>企业管理员联系邮件</AdminEmail> <Address>企业地址</Address> <MailingAddress>企业邮寄地址</MailingAddress> <ZipCode> </ZipCode> <Phone>企业 </Phone> <Fax> 号码</Fax> <Email>邮箱地址</Email> <WebSite>企业WEB网址</WebSite> <CorpLogoURL>企业LogoURL </CorpLogoURL> <UpdateTime>变更时间</UpdateTime> 名称说明数据类型长度〔字节〕 ResultCode 返回结果代码 (0: 处理成功；1: 处理失败) String 16 ResultDesc 返回结果描述 String 256 CorpID 企业客户编号 String 16 CorpName 企业客户名称 String 64 ShortName 企业客户简称 String 32 EnglishName 企业客户英文名称 String 128 EngShortName 企业客户英文简称 String 32 FQDN 企业FQDN String 256 CorpLicense 企业营业执照号 String 64 LegalPerson 企业法人 String 64 AdminPhone 企业管理员联系 String 32 AdminMobile 企业管理员联系 String 32 AdminEmail 企业管理员联系邮件 String 80 Address 企业地址 String 256 MailingAddress 企业邮寄地址 String 256 ZipCode String 6 Phone 企业 String 32 Fax 号码 String 32 Email 邮箱地址 String 80 WebSite 企业WEB网址 String 100 CorpLogoURL 企业Logo URL String 256 UpdateTime 变更时间，格式为 YYYYMMDDHHmmssfff String 17 1.2.6 企业员工信息接口 1.2.6.1 接口描述对于需要企业员工信息的ISV应用，那么实现该接口，以接受企业员工信息更新。 1.2.6.2 交互流程 1．管理员在平台中更新企业员工信息。 2． ISV定期〔按需〕从SaaS平台获取最新的企业员工信息。 3． SaaS平台将最新的企业员工信息返回至ISV。 4． ISV应用系统更新本地数据系统。 1.2.6.3 应用场景 1.2.6.4 接口定义消息类型编码 SYS10302 请求消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Request通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <CorpID>企业客户编号</CorpID> <UserIDs>用户ID ,…[n]</UserIDs> 名称说明数据类型长度〔字节〕 CorpID 企业客户编号 String 16 UserIDs 用户ID列表(以逗号分割，用户ID是Guid的串);至少包含一个用户ID String 返回消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Response通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ResultCode>返回结果代码</ResultCode> <ResultDesc>返回结果描述</ResultDesc> <CorpID>企业客户编号</CorpID> <Staffs> <Staff> <UserID>用户ID</UserID> <StaffName>用户名称</StaffName> <Alias>别名</Alias> <Sex>性别</Sex > <UserName>用户登录名</UserName> <ADAccount>用户AD 帐号</ADAccount> <SAMAccount>用户SAM帐户</SAMAccount> <Email>邮箱地址</Email> <Address> [HomeAddress]</Address> <CardID>身份证</CardID> <Birthday>出生日期</Birthday> <DeptID>部门ID </DeptID> <Position>职务</Position> <OfficePhone>办公 </OfficePhone> <MobilePhone>移动 </MobilePhone> <UpdateTime>变更时间</UpdateTime> </Staff> <Staff> …… </Staff> </Staffs> 名称说明数据类型长度〔字节〕 ResultCode 返回结果代码〔0: 成功；1: 失败〕 String 16 ResultDesc 返回结果描述 String 256 CorpID 企业客户编号 String 16 UserID 用户ID(Guid) String 36 StaffName 用户名称 String 32 Alias 别名 String 32 Sex 性别F女 M男 String 1 UserName 用户登录名 String 20 ADAccount 用户AD 帐号 String 50 SAMAccount 用户SAM帐户 String 20 Email 邮箱地址 String 80 Address String 256 CardID 证件号 String 32 Birthday 出生日期格式为 YYYYMMDD String 8 DeptID 部门ID String 16 Position 职务 String 32 OfficePhone 办公 String 24 MobilePhone 移动 String 24 UpdateTime 变更时间，格式为 YYYYMMDDHHmmssfff〔必填〕 String 17 1.2.7 企业部门信息接口 1.2.7.1 接口描述对于需要企业部门信息的ISV应用，那么实现该接口，以接受企业部门信息更新。 1.2.7.2 交互流程 1．管理员在平台中更新企业部门信息。 2． ISV定期〔按需〕从SaaS平台获取最新的企业部门信息。 3． SaaS平台将最新的企业部门信息返回至ISV。 4． ISV应用系统更新本地数据系统。 1.2.7.3 应用场景 1.2.7.4 接口定义消息类型编码 SYS10303 请求消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Request通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <Body> <CorpID>企业客户编号</CorpID> <DeptIDs>部门ID,…[n]</DeptIDs> </Body> 名称说明数据类型长度〔字节〕 CorpID 企业客户编号 String 16 DeptIDs 部门ID 列表(以逗号分割) String 256 返回消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Response通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ResultCode>返回结果代码</ResultCode> <ResultDesc>返回结果描述</ResultDesc> <CorpID>企业客户编号</CorpID> <Depts> <Dept> <DeptID>部门ID </DeptID> <ParentID>上级部门ID </ParentID> <DeptName>部门名称</DeptName> <DeptDesc>部门描述</DeptDesc> <DeptPhone>部门 </DeptPhone> <DeptFax>部门号</DeptFax> <UpdateTime>变更时间</UpdateTime> </Dept> <Dept> …… </Dept> </Depts> 名称说明数据类型长度〔字节〕 ResultCode 返回结果代码 (0: 处理成功；1: 处理失败) String 16 ResultDesc 返回结果描述 String 256 CorpID 企业客户编号 String 16 DeptID 部门ID String 16 ParentID 上级部门ID，无上级部门填0 String 16 DeptName 部门名称 String 32 DeptDesc 部门描述 String 100 DeptPhone 部门 String 32 DeptFax 部门号 String 32 DeptMgrID 部门负责人用户ID(可转换为Guid的串) String 36 UpdateTime 变更时间，格式为 YYYYMMDDHHmmssfff String 17 1.2.8 企业通讯录信息接口 1.2.8.1 接口描述对于需要企业通讯录信息的ISV应用，那么实现该接口，以接受企业通讯录信息更新。 1.2.8.2 交互流程 1．管理员在平台中更新企业通讯录信息。 2． ISV定期〔按需〕从SaaS平台获取最新的企业通讯录信息。 3． SaaS平台将最新的企业通讯录信息返回至ISV。 4． ISV应用系统更新本地数据系统。 1.2.8.3 应用场景 1.2.8.4 接口定义消息类型编码 SYS10304 请求消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Request通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <CorpID>企业客户编号</CorpID> <ContactIDs>联系人ID ,…[n]</ContactIDs> 名称说明数据类型长度〔字节〕 CorpID 企业客户编号 String 16 ContactIDs 联系人ID列表(以逗号分割).如果是空串,那么表示获取所有联系人 String 返回消息消息格式 <?xml version="1.0" encoding="UTF-8"?> <Msg> <Head>Response通用消息头〔ref: 附录〕</Head> <Body>加密后的消息体</Body> </Msg> 未加密的消息体格式 <ResultCode>返回结果代码</ResultCode> <ResultDesc>返回结果描述</ResultDesc> <CorpID>企业客户编号</CorpID> <Contacts> <Contact> <ContactID>联系人ID</ContactID> <FullName>联系人全名 </FullName> <FirstName>联系人名字 </FirstName> <MiddleName>联系人中间名 </MiddleName> <LastName>联系人姓氏 </LastName> <Title>职位</Title> <Email>电子邮件</Ema

展开阅读全文