imo开放平台帐号同步接入说明.doc

IMO 双帐号同步API文档 中国互联网办公室·imo运营中心 Revision History Revision # Author Reviewed By A. Summary of Review Issued by / Date 1.0 苏佳晶 初稿 2012/10/18 1.1 苏佳晶 2012/10/19 1.1.5 苏佳晶 2012/11/01 1.2.0 白明奇 2012/11/12 1.2.1 凌宇 2013/5/7 1.2.2 凌宇 2013/5/20 1.2.3 凌宇 加入php接入范例 2013/5/24 1.2.4 凌宇 获取变动信息加入时间格式 2013/5/27 1.2.5 凌宇 修正新增用户中参数名称 2013/5/28 1.2.6 钱鹤鸣 修改获取成员部门企业信息例子 2013/6/14 1.2.7 钱鹤鸣 移动员工，移动部门,UA支持，PWD密文支持 2013/8/27 1.2.8 凌宇 加入内部联系人接口 2013/11/12 目录1 概要 4 1.1 第三方应用同步数据到imo 4 1.2 imo同步数据到第三方应用 4 1.3 使用imo同步数据功能的前提(管理后台功能限制) 4 2 业务流程 5 2.1.1 接入方发送申请邮件，邮件内容包括要获得授权的公司账号列表和服务器ip地址 5 2.1.2 Imo 开放平台通过接入申请，为接入方发放特定API_KEY(1个32个字节长的字符串) 5 3 API 5 3.1 注册公司（新增） 5 3.1.1 获取企业信息 6 3.1.2 获取部门信息 7 3.1.3 获取组织架构信息 8 3.1.4 获取员工信息 10 3.1.5 获取企业总人数 11 3.2 同步数据 12 3.2.1 第三方应用同步数据到imo 12 3.2.2 添加员工 12 3.2.3 修改员工(管理员密码无法修改，邮箱不能为空) 14 3.2.4 删除员工 15 3.2.5 添加部门信息。 16 3.2.6 修改部门信息（不需要修改的项无需传） 17 3.2.7 删除部门信息（不支持包含子部门的删除） 18 3.2.8 修改企业信息（不需要修改的项无需传） 19 3.2.9 移动员工 20 3.2.10 移动部门 21 3.3 变动数据获取 22 3.3.1 获取变动的公司信息 22 3.3.2 获取详细的变动信息 23 3.4 联系人数据同步 25 3.4.1 创建内部联系人 25 3.4.2 创建联系人组 25 3.4.3 获取联系人组列表 26 4 错误代码说明 26 5 操作流程图 29 6 接入范例 30 概要 第三方应用同步数据到imo 通过POST方式直接提交数据至API，通过数据合法性验证后更新到imo端。 返回的数据为json_encode格式数据，编码为utf-8。 imo同步数据到第三方应用 第三方应用，通过合法性验证，通过接口获取公司信息，和组织架构，然后根据组织架构的数据结构，通过API获取相应部门和员工信息，并保存至第三方数据库。 使用imo同步数据功能的前提(管理后台功能限制) 企业邮尚易 被删除成员不能为群主(一般需要先解散群)修订历史里面没有记录 :5186/sync/sync.php 支持格式 JSON HTTP请求方式 POST 请求参数 必选 类型及范围 说明 cid true string （默认为appcid） appKey true string App key appcid true string Appcid evno true string 12 CorpCName true string 公司名称 ContactEmail true string 公司邮箱 返回结果 { Result: true, cid: 149102, caccount:} 注：此接口暂不提供使用 获取企业信息 URL http:// :5186/sync/getsync.php 支持格式 JSON HTTP请求方式 POST 请求参数 必选 类型及范围 说明 cid true string 企业 ID appKey true string App key appcid true string appcid evno true string 3 调试地址 返回结果 { cid:123456789, logo:http:\/\/:8000\/upload\/imo_server\/data\/corplogo\/43\