中国互联网办公室·imo运营中心

目录

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 获取企业信息 5

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 修改员工(管理员密码无法修改,邮箱不能为空) 13

3.2.4 删除员工 15

3.2.5 添加部门信息。 15

3.2.6 修改部门信息(不需要修改的项无需传) 16

3.2.7 删除部门信息(不支持包含子部门的删除) 18

3.2.8 修改企业信息(不需要修改的项无需传) 18

3.2.9 移动员工 20

3.2.10 移动部门 21

3.3 变动数据获取 21

3.3.1 获取变动的公司信息 22

3.3.2 获取详细的变动信息 22

4 错误代码说明 24

5 操作流程图 26

6 接入范例 28

1 概要

1.1 第三方应用同步数据到imo

通过POST方式直接提交数据至API,通过数据合法性验证后更新到imo端。

返回的数据为json_encode格式数据,编码为utf-8。

1.2 imo同步数据到第三方应用

第三方应用,通过合法性验证,通过接口获取公司信息,和组织架构,然后根据组织架构的数据结构,通过API获取相应部门和员工信息,并保存至第三方数据库。

1.3 使用imo同步数据功能的前提(管理后台功能限制)

1. 企业邮箱(尚易邮箱)感知不能使用(已绑定的,需要解绑)

2. 被删除成员不能为群主(一般需要先解散群)

3. 修订历史里面没有记录

2 业务流程

2.0.1 接入方发送申请邮件,邮件内容包括要获得授权的公司账号列表和服务器ip地址

2.0.2 Imo 开放平台通过接入申请,为接入方发放特定API_KEY(1个32个字节长的字符串)

3 API

3.1 注册公司(新增)

URL

http://open.imoffice.com: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": "66019442"

}

注:此接口暂不提供使用

3.1.1 获取企业信息

URL

http:// open.imoffice.com: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:\/\/data.imoffice.com:8000\/upload\/imo_server\/data\/corplogo\/43\/43.png",

"account":"510086",

"domain":"",

"name_cn":"u6613\u7766\u7f51\u7edc\u79d1\u6280\u6709\u9650\u516c\u53f8",

"name_en":"imo",

"name":"imo\u4e91\u529e\u516c\u5ba4",

"country":"\u4e2d\u56fd",

"city":"\u4e0a\u6d77",

"province":"\u4e0a\u6d77",

"district":"u95f8\u5317\u533a",

"address":"\u4e0a\u6d77\u5e02\u95f8\u5317\u533a\u6c5f\u573a\u4e09\u8def286-288\u53f77\u5c42",

"tel":"021-51086575",

"fax":"021-61927549",

"contact_person":"\u674e\u8302\u7acb",

"email":"qiaoyuemeng@imoffice.com",

"zip":"200082",

"website":"http://www.imoffice.com",

"intro":"\u4e2d\u56fd\u4e92\u8054\u7f51\u529e\u516c\u5ba4-imo\u8fd0\u8425\u4e2d\u5fc3\u57fa\u4e8e\u201c\u5feb\u901f\u63d0\u5347\u4e2d\u56fd\u6570\u767e\u4e07\u4e0a\u7f51\u4f01\u4e1a\u7684\u6574\u4f53\u4fe1\u606f\u5316\u6c34\u5e73\u201d\u4e4b\u4e8b\u4e1a\u5b97\u65e8\u800c\u6210\u7acb\u3002"

}

字段说明

返回值字段

字段类型

字段说明

cid

string

企业 ID

logo

string

企业logo图片URL

account

string

企业账号

domain

string

企业登陆域名

name_cn

string

企业中文名称

name_en

string

企业英文名称

name

string

企业简称

country

string

企业所在国家

city

string

企业所在市

province

string

企业所在省份

district

string

企业所在区

address

string

企业地址

tel

string

企业电话

fax

string

企业传真

contact_person

string

企业联系人

email

string

企业联系人的email地址

zip

string

企业邮编

website

string

企业网站

intro

string

企业简介

3.1.2 获取部门信息

URL

http:// open.imoffice.com:5186/sync/getsync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

appcid

dids

true

string

部门 ID(1,2), ,最多支持100个部门

evno

true

string

4

调试地址

返回结果

{

"did":"4",

"pdid":"3",

"name":"\u5206\u652f1",

"address":"",

"tel":"",

"website":"",

"intro":"\u5206\u652f1",

"fax":"02133250437-802"

}

错误

{“Result”:false, ”Msg”:” overstep dept number”,”MsgNo”:10001}超出部门数限制

字段说明

返回值字段

字段类型

字段说明

did

string

部门编号

pdid

string

父级部门编号

name

string

部门名称

address

string

部门地址

tel

string

部门电话

website

string

网址

intro

string

部门简介

fax

string

部门传真

3.1.3 获取组织架构信息

URL

http:// open.imoffice.com:5186/sync/getsync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

appcid

did

true

string

部门 ID

1. 传入0表示显示企业全部组织架构以及部门下的员工。

2. 传入非0表示只显示你传入的组织架构ID的信息以及部门下的员工。

evno

true

string

1

调试地址

返回结果

{

"did":"4",

"uids":["1010","1011","1015","1378796"],

"uas":["name1"," name2"," name3"," name4"],

"children":[

{

"did":"5",

"uids":["1029","12386","224568","234622","687281","749713","827105","1104158","1175507","1378797"],

"uas":[ a1,a2,a3,a4,a5,a6,a6,a7,a8,a9]

},

{

"did":"10",

"uids":["1035","1038","26943","82609","221413","780985","1174744","1175508","1372622","1372623","1372625","1392904","1435792"],

"uas":[……]

"children":[

{

"did":"17",

"uids":["1017","1028","991653"],

"uas":[……]

}

]

},

{

"did":"30",

"uids":["1378806","1378807","1378808"],

"uas":[……]

}

]

}

字段说明

返回值字段

字段类型

字段说明

did

string

部门编号

uids

array

部门下员工集合

children

array

子部门

pid

string

父部门ID

child_id

string

子部门ID

返回4294967295表示无子部门

sibling_id

string

同级部门ID

返回4294967295表示无同级部门

first_uid

string

部门第一个员工ID

返回4294967295表示无员工

3.1.4 获取员工信息

URL

http:// open.imoffice.com:5186/sync/getsync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

appcid

uids

false

string

员工ID(1,2),最多支持100个成员

uas

false

string

员工账号(user1,user2),最多支持100个成员(uids和uas必须且只能填写1项)

evno

true

string

2

调试地址

返回结果(gender, intro客户端做出的修改后,只有再次调用相关修改接口才会返回修改的数据)

{"did":"5",

"dname":"\u5206\u652f1",

"uaccount":"user3",

"Fpwd":"f1eeb8749a707ce11d1497dcb6cebec0",

"avatar":"http:\/\/data.imoffice.com:8000\/upload\/imo_server\/data\/userlogo\/000",

"uid":"123456",

"uname":" \u6210\u54584 ",

"birthday":"1970-12-22",

"tel":"51086575-8001",

"email":"sujiajing@imoffice.com",

"gender":"\u7537",

"position":"",

"mobile":"",

"sign":"",

"intro":"",

"uid":"4595364"}

字段说明

返回值字段

字段类型

字段说明

did

String

部门编号

uaccount

String

员工账号

Fpwd

String

员工密码

avatar

String

员工头像URL

uname

String

员工真实姓名

birthday

String

员工出生日期

tel

String

员工工作电话

email

String

员工email

gender

String

员工性别

position

String

员工职务

mobile

String

员工移动电话

sign

String

签名

intro

String

员工简介

Uid

String

员工ID

3.1.5 获取企业总人数

URL

http:// open.imoffice.com:5186/sync/getsync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

appcid

evno

true

string

23

调试地址

返回结果

{"usernum":"10"}

字段说明

返回值字段

字段类型

字段说明

usernum

String

企业总人数

3.2 同步数据

3.2.1 第三方应用同步数据到imo

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

3.2.2 添加员工

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

Appcid

user

true

string

员工信息

evno

true

string

5

pwdtype

false

string

值=MD5,user参数中passwd可以填写明文密码md5一次后的32位字符串,否则passwd为明文

参数user

必选

类型及范围

说明

字串长度

did

true

string

部门 did

11

uaccount

true

string

用户账号()

60

uname

true

string

用户真实姓名

16

passwd

true

string

用户密码()

16

birthday

false

string

用户生日

8

tel

false

string

用户电话

32

email

false

string

用户邮件地址

108

gender

true

string

用户性别

1(1为男性:0为女性)

position

false

string

用户职位

32

mobile

false

string

用户手机号码

32

intro

false

string

用户简介

role

false

string

用户身份

10组织管理员(副),5为普通员工

Base64_encode({

"did":"13",

"uaccount":"user",

"uname":"王东",

"passwd":"123456",

"birthday":"19701222",

"tel":"51086575-8001",

"email":"sujiajing@imoffice.com",

"gender":"0",

"position":"web架构师",

"mobile":"13783235608",

"role":"5",

"intro":""

})

返回结果

成功

{“Result”:true, ”Msg”:”员工同步成功”,”Uid”:XXX}

失败

{“Result”:false, ”Msg”:”员工同步失败”,”MsgNo”:10005}

3.2.3 修改员工(管理员密码无法修改,邮箱不能为空)

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

appcid

uid

False

string

用户uid (uid和uaccount必选其一)

uaccount

False

String

用户账号(uid和uaccount必选其一)

user

true

string

修改信息

evno

true

string

6

pwdtype

false

string

值=MD5时,user参数中passwd可以填写明文密码md5一次后的32位字符串,否则passwd为明文

参数user

必选

类型及范围

说明

字串长度

uid

true

string

11

did

true

string

部门 did

11

uaccount

false

string

用户账号()

60

uname

false

string

用户真实姓名

16

passwd

false

string

用户密码()

16

birthday

false

string

用户生日

8

tel

false

string

用户电话

32

email

false

string

用户邮件地址

108

gender

false

string

用户性别

1(1为男性:0为女性)

position

false

string

用户职位

32

mobile

false

string

用户手机号码

32

role

false

string

用户身份

10组织管理员(副),5为普通员工

Base64_encode({

"did":"13",

"uaccount":"1410177",

"uid":"123",

"uname":"王东",

"passwd":"123456",

"birthday":"1970-12-22",

"tel":"51086575-8001",

"email":"sujiajing@imoffice.com",

"gender":"男",

"position":"web架构师",

"mobile":"13783235608",

"role":"5",

"intro":""

})

返回结果

成功

{“Result”:true, ”Msg”:”员工同步成功”}

失败

{“Result”:false, ”Msg”:”员工同步失败”,”MsgNo”:10005}

3.2.4 删除员工

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

appcid

uid

False

string

用户uid (uid和uaccount必选其一)

uaccount

False

String

用户账号(uid和uaccount必选其一)

did

true

string

部门id

Evno

true

string

7

返回结果

成功

{“Result”:true, ”Msg”:” 员工同步成功”}

失败

{“Result”:false, ”Msg”:”员工同步失败”,”MsgNo”:10005}

3.2.5 添加部门信息。

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

appcid

dept

true

string

部门信息

evno

true

string

8

参数dept详解

必选

类型及范围

说明

字串长度

pdid

true

string

父级did(0表示无父级部门)

11

name

true

string

App key

40

address

false

string

部门信息

64

tel

false

string

分支电话

32

website

false

string

分支网址

64

intro

false

string

分支简介

64

fax

false

string

分支传真

32

Base64_encode({

"pdid":"3",

"name":"研发中心",

"address":"",

"tel":"",

"website":"",

"intro":"负责研发",

"fax":"02133250437-802"

}

)

返回结果

成功

{“Result”:true, ”Msg”:”部门同步成功”,”Did”:XXX}

失败

{“Result”:false, ”Msg”:”部门同步失败”,”MsgNo”:10004}

注:did为零表示为根节点.

3.2.6 修改部门信息(不需要修改的项无需传)

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

appcid

did

true

string

部门did

dept

true

string

部门信息

evno

true

string

9

参数dept

必选

类型及范围

说明

字串长度

did

true

string

部门did

11

pdid

false

string

父级did(0表示无父级部门)

11

name

false

string

部门名称

40

address

false

string

部门地址

64

tel

false

string

分支电话

32

website

false

string

分支网址

64

intro

false

string

分支简介

64

fax

false

string

分支传真

32

Base64_encode({

"did":"4",

"pdid":"3",

"name":"研发中心",

"address":"",

"tel":"",

"website":"",

"intro":"负责研发",

"fax":"02133250437-802"

}

)

返回结果

成功

{“Result”:true, ”Msg”:”部门同步成功”}

失败

{“Result”:false, ”Msg”:”部门同步失败”,”MsgNo”:10004}

3.2.7 删除部门信息(不支持包含子部门的删除)

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

Appcid

did

true

string

部门did

evno

true

string

10

返回结果

成功

{“Result”:true, ”Msg”:”部门同步成功”}

失败

{“Result”:false, ”Msg”:”部门同步失败”,”MsgNo”:10004}

3.2.8 修改企业信息(不需要修改的项无需传)

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

Appcid

cinfo

true

string

企业信息

evno

true

string

11

参数cinfo

Base64_encode({

"cid":"123456789",

"logo":"http://corpmgr.imoffice.com/imo_server/data/corplogo/43/43.jpg",

"account":"510086",

"domain":"",

"name_cn":"易睦网络科技有限公司",

"name_en":"imo",

"name":"imo云办公室",

"country":"中国",

"city":"上海",

"province":"上海",

"district":"闸北区",

"address":"洛川中路840号B栋7楼",

"tel":"021-51086575",

"fax":"021-61927549",

"contact_person":"李茂立",

"email":"qiaoyuemeng@imoffice.com",

"zip":"200082",

"website":"http://www.imoffice.com",

"intro":"中国互联网办公室-imo运营中心基于“快速提升中国数百万上网企业的整体信息化水平”之事业宗旨而成立。"

})

成功

{“Result”:true, ”Msg”:” 企业同步成功”}

失败

{“Result”:false, ”Msg”:”企业同步失败”,”MsgNo”:10003}

字段说明

返回值字段

字段类型

字段说明

字串长度

cid

string

企业 ID

account

string

企业账号

name_cn

string

企业中文名称

32

name_en

string

企业英文名称

32

name

string

企业简称

10

country

string

企业所在国家

固定标准

city

string

企业所在市

province

string

企业所在省份

district

string

企业所在区

address

string

企业地址

64

tel

string

企业电话

32

fax

string

企业传真

32

contact_person

string

企业联系人

16

email

string

企业联系人的email地址

64

zip

string

企业邮编

6

website

string

企业网站

64

intro

string

企业简介

64

3.2.9 移动员工

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

企业 ID

appKey

true

string

App key

appcid

true

string

Appcid

evno

true

string

13

MoveId

true

string

移动员工UID(MoveId和MoveUa 至少填写一个)

MoveUa

true

string

移动员工的账号(MoveId和MoveUa 至少填写一个)

FromParentId

true

string

员工原部门DID

ToParentId

true

string

移动到的部门DID

返回结果

成功

{“Result”:true, ”Msg”:”ok”}

失败

{“Result”:false, ”MsgNo”: 21302}

3.2.10 移动部门

URL

http:// open.imoffice.com:5186/sync/sync.php

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

String

企业 ID

appKey

true

String

App key

appcid

true

String

Appcid

evno

true

String

14

DeptId

true

String

移动部门DID

FromParentId

true

String

原部门DID

ToParentId

true

String

移动到的部门DID

Type

false

String

分支隐藏  为 1时继承上级部门的属性

ApplyToSonDeptFlag

false

String

同上(这2个参数必须同时填写并为1才有效)

返回结果

成功

{“Result”:true, ”Msg”:”ok”}

失败

{“Result”:false, ”MsgNo”: 21401}

3.3 变动数据获取

URL

http:// open.imoffice.com:5186/sync/getsync.php

3.3.1 获取变动的公司信息

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

cid

appKey

true

string

App key

appcid

true

string

Appcid

evno

true

string

20

offset

false

string

偏移量(从第s条读取)

starttime

true

string

开始时间(格式:unix timestamp)

endtime

true

string

结束时间(格式:unix timestamp)

recordnumber

false

string

返回条数(1-1000)

返回:

成功

{“Result”:true, ” MsgNo”:” ok”, ” Cids”:” [{"cid":"69629"},{"cid":"69629"}]”}

失败

{“Result”:false, ”Msg”:”企业同步失败”,”MsgNo”:10003}

3.3.2 获取详细的变动信息

支持格式

JSON

HTTP请求方式

POST

请求参数

必选

类型及范围

说明

cid

true

string

要获取的公司信息

appKey

true

string

App key

appcid

true

string

Appcid

evno

true

string

21

offset

false

string

偏移量(从第s条读取)

starttime

true

string

开始时间(格式:unix timestamp)

endtime

true

string

结束时间(格式:unix timestamp)

recordNumber

false

string

返回条数(1-1000)

返回参数

成功返回:

{"Result":"true","MsgNo":"ok","StructInfo": [{"id":"22","createtime":"1367906660","operation":"{'EventNo':'3','CorpId':'69629','CorpENam':,'CorpShortName':,'CorpAds':,'ContactCountry':,'ContactCity':,'ContactProvince':,'ContactDistrict':,'ContactAddr':,'ContactTel':,'ContactFax':,'ContactPerson':,'ContactEmail':,'ContactPostCode':,'ContactWebSite':,'CorpPlusProperty':,'CorpPlusIndustry':')','CorpPlusScope':'0','CorpPlusEmpNum':'0','CorpPlusComputerNum':'1','CorpPlusDescrip': }"}]}

其中:operation:表示具体操作行为。

EventNo为操作行为标识,分别为:

l 3.企业信息修改

{"EventNo":"3","CorpId":"69629","CorpDomain":"\u4f60\u597d\u80fd.com","CorpCName":"imo \u6d4b\u8bd5","CorpEName":"","CorpShortName":"\u6d4b\u8bd5\u4f01\u4e1a","CorpAds":"","ContactCountry":"\u4e2d\u56fd","ContactProvince":"\u4e0a\u6d77","ContactCity":"\u4e0a\u6d77","ContactDistrict":"\u4e0a\u6d77\u5e02","ContactAddr":"\u529e\u516c\u5730\u5740","ContactTel":"021-11111111","ContactFax":"","ContactPerson":"\u6d4b\u8bd5","ContactEmail":"41564941@qq.com","ContactPostCode":"0","ContactWebSite":"","CorpPlusProperty":"null","CorpPlusIndustry":"(@T,4700)","CorpPlusScope":"0","CorpPlusEmpNum":"0","CorpPlusComputerNum":"1","CorpPlusDescrip":""}

l  12.创建部门

{"EventNo":"12","CorpId":"69629","DeptDescrip":"","DeptName":"test123","DeptAddr":"","DeptTel":"","DeptWebsite":"","ParentDeptId":"0","DeptId":"10"}

l 9.更新部门信息

{"EventNo":"9","CorpId":"69629","DeptId":"15","DeptDescrip":"","DeptAddr":"111","DeptTel":"111","DeptWebsite":"","DeptName":"test111","DeptPlusEFax":""}

l 34.拖动部门

{"EventNo":"34","CorpId":"69629","Version":"3","DeptId":"15","FromParentId":"0","FromPreNodeId":"14","ToParentId":"14","ToPreNodeId":"-1"}

l 53.删除部门及成员

{"EventNo":"53","CorpId":"10000","DeptId":"578"}

此操作被删除部门下子部门和成员一起被删除。

l 11.更新员工信息

{"EventNo":"11","CorpId":"69629","EmpId":"3401502","RAccount":"abc","EmpName":"aaabbbccc","EmpWorkTel":"","EmpEmail":"","EmpMobilePhone":"","EmpDescrip":"","EmpPosition":"","EmpGender":"1","EmpRole":"5","UpdatePwdFlag":"0","EmpIniPassword":"","UpdateSexOrNameFlag":"1","EmpBirthday":"19800101","DeptId":"15"}

l 13.新建员工

{"EventNo":"13","CorpId":"69629","EmpAccount":"abc","CorpAccount":"4539122","EmpName":"abc","EmpBirthday":"19800101","EmpWorkTel":"","EmpEmail":"","EmpGender":"1","EmpPosition":"","EmpMobilePhone":"","EmpRole":"5","EmpDescrip":"","DeptId":"15","EmpId":"10"}

l 14.移动员工

{"EventNo":"14","CorpId":"69629","Version":"6","MoveId":"3401502","FromParentId":"15","FromPreNodeId":"-1","ToParentId":"14","ToPreNodeId":"3401500"}

l 26.删除成员

{"EventNo":"26","CorpId":"10000","EmpId":"3389122"}

失败返回:

{"Result":"false","MsgNo":"20001"}

4 错误代码说明

服务级错误代码

错误代码

错误信息

详细描述

通用

20001

Parameter is null

参数为空

20002

Parameter cid is null

企业ID为空

20003

Parameter app key is null

应程序密钥

20004

Parameter Vaildate error

参数校验错误

20005

Parameter start time is null

同步起始时间为空

20006

Parameter end time is null

同步结束时间为空

20007

Invalid app key

App key不合法

20008

Invalid server ip

Server ip 地址不合法

20009

Contain nauthorized Company

包含未授权的公司cid

20010

System Exception

内部异常

20011

not activated

未激活

20012

have expired

已过期

20013

no sync authority

操作没有授权

20014

Interface busy

接口忙

2

20201

Overstep user numnber

超出获取数量限制

20202

User empty

无用户信息

3

20301

CorpInfo Empty

无企业信息

4

20401

Overstep dept number

超出获取部门数

20402

Dept empty

无部门信息

5

20501

User is exist

成员已存在

20502

Overstep corp user number

超出企业人数

20503

Overstep dept user number

超出部门人数

20504

LICENSE FALSE

LICENSE不足

20505

PUSH USER IN ROOT

根下不能推成员

6

20601

Admin unpermision

管理员无法修改

20602

Unkown permission type

未知的成员权限类型

20603

USER_RELATION_EMPTY

员工关系错误

7

20701

Grouphost is undel

群主无法删除

20702

Admin is undel

管理员不法删除

20703

User info is empty

获取用户信息错误

8

20801

Dept is exist

部门已存在

20802

Overstep dept number

超出部门限制数量

10

21001

Have children node

被删除部门包含成员和部门

21002

Get parentid error

获取被删除部门父部门出错

11

22001

STRUCT_NO_CHANGE

组织无变动

22002

STRUCT_NUMBER_OVERRUN

拉取条数超过限制大小

13

21301

Parameter miss

参数缺失

21302

DEPT_NUMBER_OVERRUN

部门人数超过限制

21303

OPREATION_LOCKED

操作被锁定

21304

INTERNAL_ERROR

内部错误

21305

DB_ OPREATION _ERROR

数据库操作失败

21306

MOVE_IN_ROOT

根下不能移动

21307

MOVE_IN_SY_DEPT

不能移动到尚易根目录下

14

21401

STRUCT_ CHANGED

组织架构已经变化

21402

DB_ OPREATION _ERROR

数据库操作失败

21403

INTERNAL_ERROR

内部错误

21404

DB_OPREATION_ERROR_HIDE

数据库操作失败(继承隐藏时发生)

21405

INTERNAL_ERROR_HIDE

内部错误(继承隐藏时发生)

21406

Parameter miss

参数缺失

21407

MOVE_IN_SY_DEPT

不能移动到尚易根目录下

21408

SY_DEPT_MOVE

尚易根目录不能被移动

21409

SAME_DEPT_NAME

发现相同的部门名称

21410

MOVE_IN_CHILD

部门不能移动到自己的子部门下

5 操作流程图

6 接入范例

以下用获取企业信息接口为例:

php:

<?php

$cid = ‘123’;

$appKey = ‘96e79218965eb72c92a549dd5a330112’;

$appcid = ‘123’;

$evno = ‘3’

$url =’ http:// open.imoffice.com:5186/sync/getsync.php’;

$process = curl_init($url);

$param = ‘cid=’.$cid.’&appKey=’.$appKey.’&appcid=’.$appcid.’&evno=3’;

curl_setopt($process, CURLOPT_POSTFIELDS, $param);//设置post提交的参数

curl_setopt($process, CURLOPT_POST, 1);//设置post超时

ob_start();

$return = curl_exec($process);//发送post请求

$content = ob_get_contents();

ob_end_clean();

curl_close($process);

echo $content; //输出返回结果

?>

http://www.yxxx.net.cn 西安云翔软件信息科技有限公司

IMO 双帐号同步API文档相关推荐

  1. (电商API文档)更新电子面单号

    想要及时更新电子面单号对应的面单信息,首先要对接好电商平台的电子面单接口,才能将平台变动后的收件信息及时更新到电子面单上,没有对接电商平台的ERP.WMS系统可以通过点三API接口来获取打印和更新电子 ...

  2. 还在发愁写API文档?推荐一款阿里腾讯都在用的API管理神器!

    欢迎关注方志朋的博客,回复"666"获面试宝典 前言 ❝ 程序员最讨厌的两件事:1. 写文档,2. 别人不写文档.大多数开发人员不愿意写 API 文档的原因:写文档短期收益远低于付 ...

  3. springboot api文档_SpringCloud/SpringBoot - 自动生成API文档

    SpringCloud/SpringBoot 的项目一定要前后分离,这就需要一个API文档生成的工具,后端一定要和前端或者是移动端对接接口,那么问题来了,接口是不是要自己写给他们看,一般的会采用Exc ...

  4. 一款适合IT团队的在线API文档、技术文档工具-showdoc介绍

    还在为word文档传来传去查阅不方便而烦恼吗,还在为查看数据库字段含义不方便而烦恼吗,还在为编写接口文档而烦恼吗?今天为大家推荐一款适合IT团队的在线API文档.技术文档工具,有免费开源和在线托管的版 ...

  5. SpringBoot 自动生成API文档

    SpringBoot 自动生成API文档 在做项目的时候,如果项目是前后分离的,后端一定要和前端或者是移动端对接接口,那么问题来了,接口是不是要自己写给他们看,一般的会采用Excel或者Word来写, ...

  6. 干掉 Postman?测试接口直接生成API文档,这个文档工具真香!

    欢迎关注方志朋的博客,回复"666"获面试宝典 实不相瞒我的收藏夹里躺着很多优质的开源项目,我有个爱好平时遇到感兴趣的开源项目都会记录下来,然后有时间在慢慢研究.前几天刚给同事分享 ...

  7. Spring Boot 2.x基础教程:使用Swagger2构建强大的API文档

    点击蓝色"程序猿DD"关注我 回复"资源"获取独家整理的学习资料! 作者 | 翟永超 来源 | didispace.com/spring-boot-learni ...

  8. javadoc - Java API 文档生成器(Windows版本)

    文章目录 简介 命令语法结构 Javadoc Doclets 术语 带文档的类 引用类 外部引用类 源文件 源代码文件 包注释文件 概述注释文件 其他未处理文件 生成的文件 基本内容页 交叉参考页 支 ...

  9. 爽到爆!阿里腾讯都在用的API管理神器,API文档、测试、Mock全搞定

    作为一个后端开发,我做的大部分项目一般都是基于 Swagger 来管理 API 文档,基于 Postman 来做接口调试,基于 JMeter 来做接口性能测试,基于 RAP 等工具 Mock API ...

  10. VScode编辑同步Markdown文档到印象笔记

    VScode编辑同步Markdown文档到印象笔记 第一步 下载VSCode 到Visual Studio Code官网下载VSCode,并安装 第二步 安装VScode相关插件 需要两个插件: ev ...

最新文章

  1. CMakeLists.txt的运行方法
  2. 简单示例,VS2019调试C语言程序
  3. 平滑动画 每秒60帧 -- 16ms内绘完一帧
  4. 基于visual Studio2013解决面试题之0802数字最多元素
  5. python安装lxml,在windows环境下
  6. CVPR2021 Oral|只用静态图,实时渲染出丝滑3D效果
  7. 程序员除了会 CRUD 之外,还应该知道什么叫 CQRS!
  8. movavi video editor plus教程:在Mac上给视频配音
  9. JS中一些常用的函数(持续更新)
  10. 【国土】国土“三调”,用这个方案就对了
  11. “磁碟机”病毒技术分析报告
  12. Java蓝桥杯 算法提高 九宫格
  13. dos下c语言读取扇区的函数,C语言编程读取主导扇区.doc
  14. wifi的几种加密方式
  15. 「L2TP」- Layer 2 Tunneling Protocol @20210210
  16. 测试工具和测试自动化
  17. 爬取网站时返回的html是乱码问题解决
  18. 好程序员云计算培训分享学了云计算将来就业怎么样?
  19. 数据库恢复挂起解决办法
  20. FPA笔记五 计算ILF/EIF功能点

热门文章

  1. linux sox录音时间控制,SOX的一些命令和kaldi使用sox音频数据增强
  2. [SAS Hard Coding] 车型对应车商代码
  3. 计算机是什么信号转换为什么信号,模拟信号转化为数字信号的原理是什么
  4. python爬取搜狐最新时政新闻数据
  5. 《Excel大神上分攻略》学习笔记1——填充、行列操作、数据格式
  6. 番茄花园 产业链 洪磊 中国
  7. OSChina 周二乱弹 ——我FFFF……佛慈悲
  8. redission实现分布式锁
  9. 2020年阿里云服务器租用价格表(实时更新)
  10. UnityVR-初识Unity-实践-制作一个工程场景