术语
应用上线:变更应用状态为已上线状态,表示应用接入开发、测试完成,达到可用状态;
应用上架:将加入指定的应用市场,机构管理员可在机构的应用市场看到应用,可执行应用安装的操作;
应用安装:也叫应用授权,将应用安装到机构,应用将出现在机构的应用列表中,机构成员可以点击打开应用;
凭证:由教育号派发的动态票据,过期后将会无效。第三方应用可根据开放API的权限要求,使用相应的凭证来进行调用;
接口字段
字段名 |
类型 |
说明 |
appid |
uint64 |
又名SuiteId,开发者在教育号注册应用时由教育号分配的应用id |
secret |
string |
又名SuiteKey或SuiteSecret,应用密钥 |
corpid |
uint64 |
机构id,表示一个学校或教育行政机构 |
department_id |
uint64 |
组织架构id,表示一个机构内的部门,在机构内唯一; |
userid |
string |
用户id,表示一个机构内用户,在机构内唯一;corpid+userid可以全局范围内唯一标识一个用户; |
child_id |
string |
孩子的userid,同userid |
role_id |
uint32 |
角色id, 参考角色类型 |
suite_ticket |
string |
suite_ticket 与 secret 配套使用,用于获取 suite_access_token |
凭证类型
凭证类型 |
字段命名 |
说明 |
适用场景 |
获取方式 |
用户凭证 |
access_token |
用户token,表示用户身份 |
用于调用开放API |
用户凭证管理 |
应用凭证 |
suite_access_token |
应用token,代表应用身份 |
用于调用开放API |
应用凭证管理 |
机构凭证 |
access_token |
机构token,代表应用在机构中的身份 |
用于调用开放API |
应用安装授权 |