服务API接口说明

第三方用户请求外勤365公共平台格式要求,请求数据仅支持以POST方式提交请求,请求头Content-Type: application/json;charset=utf-8,请求消息体为JSON格式数据。开放接口服务器通过检验digest对请求进行校验(下面有校验方式)。若确认此次POST请求为正常请求,则接入生效,否则接入失败。
加密/校验流程如下:

1. 开发者需要将请求数据按“消息体|appkey|timestamp”格式拼成字符串

2. 将三个参数拼接成的字符串进行MD5加密,生成数据签名

3. 开放接口服务器获得加密后的字符串后,重新根据规则生成数据签名对比,标识该请求是否为正常请求

外勤365开放接口URL格式如下:

https://openapi.waiqin365.com/api/{应用编码}/{应用版本}/{接口编码}/{openid}/{timestamp}/{disgest}/{msg_id}

参数说明:

URL参数 格式说明
应用编码 需要对接的功能模块,如部门信息为:organization
应用版本 对接应用的版本号,如:v1
接口编码 对接应用的接口,如新增部门:addOrganization
openid 企业接入唯一授权标识,为19位随机字符串,由外勤365统一分配
appkey 企业授权数据签名密钥,为18位随机字符串,由外勤365分配
timestamp 请求消息时间,格式为:yyyyMMddHHmmSS如:20140701142836
digest 数据签名,使用32位小写字母,用于验证数据的真实性。数据校验码生成规则:md5(消息体|appkey|timestamp),
msg_id 消息ID,发送消息的唯一标识,响应时原值返回。

外勤365开放接口消息体格式如下:

请求消息体,格式为:JSON格式数据,如 新增部门请求消息体示例

请求示例:

新增部门接口示例:

企业OPENID: 5465103569540931532

企业APPKEY: BFCO0PAgIUgd50c0l6

示例数据:

{"org_id":"ORG001","org_name":"南京掌控网络","org_parent_id":"","org_sequence":001}

获取时间戳为:20150806142836

生成消息ID:ORG00001 (随机生成)

digest=Md5({"org_id":"ORG001","org_name":"南京掌控网络","org_parent_id":"","org_sequence":001}|BFCO0PAgIUgd50c0l6|20150806142836)

生成数据签名(digest)为:74267bf0cae0998a719879ec9b3c7780

生成请求URL:

https://openapi.waiqin365.com/api/organization/v1/addOrganization/5465103569540931532/20150806142836/74267bf0cae0998a719879ec9b3c7780/ORG00001

消息体:

{"org_id":"ORG001","org_name":"南京掌控网络","org_parent_id":"","org_sequence":001}

参数 说明
return_code 响应码 0成功 1 失败
return_msg 响应信息
msg_id 消息唯一标识
response_data 响应数据: JSON格式的字符串消息体

// 示例:
{
    "msg_id": "90b4b267dd3d49aeace879038b1e7291",
    "response_data": "[{\"org_name\":\"掌控网络下级部门\",\"org_id\":\"zk001\",\"org_sequence\":\"11\",\"org_code\":\"zhangkong\",\"org_status\":\"1\",\"org_parent_id\":\"zk01\"}]",
    "return_code": 0,
    "return_msg": ""
}