应用同步接口开发步骤
该开发步骤主要针对校内应用,应用端需根据SID提供的群组对接API开发接口,实现数据同步。
数据同步方式一:实现群组节点管理和人员管理相关接口
STEP 1:获取APPID、APPSECRET,验证SID请求数据的合法性。验证方法参考:群组推送安全验证。
APPID、APPSECRET是锐捷和应用方约定(任一方提供时,另一方与其保持一致即可)的一组数据。
STEP 2:开发同步接口。
应用端(与SID对接的应用)开发人员需实现9个接口,便于SID调用,接口分为两类:
-
创建群组节点:新建一个群组节点。
更新群组节点:更新某个群组节点的信息。
删除群组节点:删除某个群组节点。
查询某个群组节点:查询某个群组节点及子节点信息。
-
创建成员:新建一个人员信息。
更新成员:更新某个人员的信息。
删除成员:删除某个人员信息。
查询成员:查看某个人员的信息。
获取群组节点下成员:查询某个群组节点下有哪些人员。
STEP 3:建立群组并推送群组数据。
STEP 4:测试并修改已编写的接口。
数据同步方式二:实现标签推送相关接口
STEP 1:开发同步接口。
应用端(与SID对接的应用)开发人员需实现7个接口,便于SID调用:
-
创建标签。
更新标签名字。
删除标签。
获取标签成员。
增加标签成员。
删除标签成员。
获取标签列表。
STEP 2:建立推送任务,推送标签数据。
- 在SID管理端创建身份标签。
- 建立标签推送任务。
- 推送标签数据。
STEP 3:测试并修改已编写的接口。
接口返回状态码的说明
错误码 | 说明 |
---|---|
200 | 接口正常返回 SID在推送群组节点、成员数据时,会首先调用查询接口 返回200时,才会继续执行数据推送,否则SID会记录推送失败信息,后续尝试继续推送数据 |