组织的接口需要使用组织的密钥才能访问

获取应用列表

URL:GET /openapi/company/{组织短名字}/app

返回内容:

  1. {
  2. "status": 0,
  3. "msg": "",
  4. "data": [
  5. {
  6. "id": "grOwVRwNXG", // 应用 id
  7. "key": "92a54", // 短名字
  8. "logo": "", // logo 图片地址
  9. "name": "名称",
  10. "description": "描述",
  11. "isDraft": false // 如果从未发布就是 true
  12. }
  13. ]
  14. }

创建应用

URL: POST /openapi/company/{组织短名字}/app

提交的内容格式

  1. {
  2. "owner": "xxxxx@xx.com", //「必填」 所属用户的邮箱地址
  3. "name": "AppName", //「必填」 应用名字
  4. "key": "xxx", // 应用短名字,弄个好记的名字,决定应用访问路径
  5. "description": "", // 描述
  6. "logo": "http://xxxx.com/xxx.png" // 应用 logo
  7. }

批量导入组织架构

URL:POST /openapi/company/{组织短名字}/department/import

提交内容格式:

  1. {
  2. "departments": [
  3. {"部门编号": "0", "部门名称": "测试专用组织根部门", "上级部门编号": ""},
  4. {"部门编号": "1", "部门名称": "测试专用组织子部门", "上级部门编号": "0"}
  5. ],
  6. "users": [
  7. {
  8. "用户名": "张三",
  9. "邮箱": "zhangsan@xxx.com",
  10. "手机": "12345678901",
  11. "昵称": "张三",
  12. "所属部门编号": "0",
  13. "是否经理": "1",
  14. "第三方登录方式": "xxx",
  15. "第三方用户ID": "123456"
  16. }
  17. ]
  18. }

提交的字段有两个,一个是部门信息,它是树形结构的,如果上级部门编号是空则代表最顶级部门;另一个是用户列表,其中第三方登录方式主要用于 oauth