MasterGo OpenAPI

MasterGo OpenAPI 文档

说明

标签说明

标签说明
私有化标签在接口标题前,说明该接口仅私有化部署可用
标签在字段中标识,说明该字段仅私有化部署可用
已废弃
已弃用
接口或请求参数或响应参数已有其他替代,不推荐使用
Beta接口或请求参数或响应参数处于 Beta 阶段,可能会有变动

排序说明

OpenAPI 中排序相关的字段,一般默认使用 -updated_at 排序,表示按更新时间降序排序。
对于某个排序字段,如果没有前置排序符号则说明是按升序排序,否则按倒序排序。
例如 created_at 表示按创建时间升序排序,-created_at 表示按创建时间降序排序。

其他说明

  • 当前所有的 OpenAPI 接口都可以使用 X-MG-Authentication 这个 HTTP Header 来进行鉴权;
    X-MG-INT-Authentication 是非必要的鉴权头,仅用于少数的私有化集成场景,非私有化场景忽略 X-MG-INT-Authentication 即可。

接口鉴权

获取 AccessToken

请求方法: POST

请求路径: /openapi/v1/organization/application/token

接口描述: 根据 app_idapp_secret 获取 AccessToken, 请求 /openapi/v1 开头的开放接口时,需要将调用本接口获取的 token 作为 X-MG-Authentication 头传入

请求体

参数名标签类型必填默认值描述
app_idstring企业应用 ID;
可在企业管理后台的【应用管理】页面中获取
app_secretstring企业应用密钥;
可在企业管理后台的【应用管理】页面中获取

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "expire": 0,
    "token": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ expireinteger
  └─ tokenstring
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

登录注册

私有化 注册用户

请求方法: POST

请求路径: /openapi/v1/signup

接口描述: 注册用户仅支持私有化环境使用,且仅支持通过邮箱注册,调用接口后会在后台登录并返回登录信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
emailstring邮箱
sourceIdstring三方(客户)系统唯一的用户 ID
usernamestring用户名

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "createdAt": "string",
    "email": "string",
    "id": 0,
    "job": "string",
    "name": "string",
    "phoneNumber": "string",
    "session_id": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ createdAtstring创建时间
  └─ emailstring邮箱
  └─ idinteger用户 ID
  └─ jobstring职位
  └─ namestring用户名
  └─ phoneNumberstring手机号
  └─ session_idstring会话 ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

用户

获取企业成员列表

请求方法: GET

请求路径: /openapi/v1/organization/users

接口描述: 分页获取企业成员信息列表,不包含企业访客

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
pageNumQueryinteger当前页数,从1开始
pageSizeQueryinteger每页大小,最大为 500

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "avatar": "string",
      "email": "string",
      "id": 0,
      "name": "string"
    }
  ],
  "meta": {
    "page": {
      "total": 0
    },
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ avatarstring头像
    └─ emailstring邮箱
    └─ idinteger用户ID
    └─ namestring用户名
metaobject
  └─ pageobject分页信息
    └─ totalinteger总条数
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取团队成员

请求方法: GET

请求路径: /openapi/v1/team/:teamId/users

接口描述: 获取指定团队下的所有成员信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "avatar": "string",
      "email": "string",
      "id": 0,
      "name": "string",
      "sourceId": "string",
      "teamRole": {
        "documentPermission": "string",
        "role": "string"
      }
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ avatarstring头像
    └─ emailstring邮箱
    └─ idinteger用户ID
    └─ namestring用户名
    └─ sourceIdstring所有者三方 ID(仅私有化集成返回)
    └─ teamRoleobject团队角色
      └─ documentPermissionstring团队编辑权限
      └─ rolestring团队角色
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

查询用户 ID

请求方法: GET

请求路径: /openapi/v1/user

接口描述: 根据 userCode 或 identity 信息查询用户ID

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userCode已弃用私有化Querystring三方(客户)系统唯一的用户 ID,推荐使用 identityType 和 identityId 进行查询
identityTypeQuerystring用户身份类型;
  • email:identityId 为邮箱
  • userId:identityId 为用户 ID
  • sourceId:identityId 为三方(客户)系统唯一的用户 ID(仅私有化)
identityIdQuerystring用户身份ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "isDeleted": true,
    "userId": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ isDeletedboolean是否已被删除
  └─ userIdinteger用户ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取用户信息

请求方法: GET

请求路径: /openapi/v1/users/:userId

接口描述: 获取指定用户的信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "avatar": "string",
    "email": "string",
    "id": 0,
    "name": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ avatarstring头像
  └─ emailstring邮箱
  └─ idinteger用户ID
  └─ namestring用户名
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 获取文件成员权限

请求方法: POST

请求路径: /openapi/v1/document/members/permissions

接口描述: 获取文件成员权限

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
userIdsarray<integer>用户ID列表
documentIdinteger文件ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "permissions": [
      {
        "docPerm": "string",
        "role": "string",
        "userId": 0
      }
    ]
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ permissionsarray<object>
    └─ docPermstring权限
    └─ rolestring角色
    └─ userIdinteger用户ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 根据三方系统信息获取用户信息

请求方法: POST

请求路径: /openapi/v1/oauth/users

接口描述: 根据三方系统信息批量获取用户信息,仅对私有化开放

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头
X-MG-INT-Authentication私有化string集成认证头

请求体

参数名标签类型必填默认值描述
sourceTypestring三方系统类型,目前仅支持 integration
sourceIdsarray<string>三方系统用户ID列表

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "sourceId": {
      "userId": 0
    }
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ sourceIdobject三方系统用户ID,这里的返回结构实际上是一个 map 结构
{"sourceId1": {"userId": userId1}, "sourceId2": {"userId": userId2}}
    └─ userIdinteger用户ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 搜索企业成员信息

请求方法: POST

请求路径: /openapi/v1/organization/users

接口描述: 搜索企业用户,目前仅对私有化部署开放

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
keywordstring关键词,用于搜索用户名或邮箱
userIdsarray<integer>用户ID列表
pageNuminteger当前页数,从1开始
pageSizeinteger每页大小

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "avatar": "string",
      "email": "string",
      "id": 0,
      "name": "string",
      "nickname": "string"
    }
  ],
  "meta": {
    "page": {
      "total": 0
    },
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ avatarstring头像
    └─ emailstring邮箱
    └─ idinteger用户ID
    └─ namestring用户名
    └─ nicknamestring昵称/企业成员名称
metaobject
  └─ pageobject分页信息
    └─ totalinteger总条数
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 获取项目成员权限

请求方法: POST

请求路径: /openapi/v1/project/members/permissions

接口描述: 获取项目成员权限

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
userIdsarray<integer>用户ID列表
projectIdinteger项目ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "permissions": [
      {
        "docPerm": "string",
        "role": "string",
        "userId": 0
      }
    ]
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ permissionsarray<object>
    └─ docPermstring权限
    └─ rolestring角色
    └─ userIdinteger用户ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 获取团队成员权限

请求方法: POST

请求路径: /openapi/v1/team/members/permissions

接口描述: 获取团队成员权限

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
userIdsarray<integer>用户ID列表
teamIdinteger团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "permissions": [
      {
        "docPerm": "string",
        "role": "string",
        "userId": 0
      }
    ]
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ permissionsarray<object>
    └─ docPermstring权限
    └─ rolestring角色
    └─ userIdinteger用户ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 更新用户基础信息

请求方法: PUT

请求路径: /openapi/v1/user

接口描述: 更新用户基础信息,仅对私有化开放

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
identityTypestring用户身份类型;
  • email:identityId 为邮箱
  • userId:identityId 为用户 ID
  • sourceId:identityId 为三方(客户)系统唯一的用户 ID(仅私有化)
identityIdstring用户身份ID
usernamestring更新的用户名
emailstring更新的邮箱
orgStructurestring更新的组织结构

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "email": "string",
    "userId": 0,
    "username": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ emailstring更新后的邮箱
  └─ userIdinteger用户ID
  └─ usernamestring更新后的用户名
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 删除用户

请求方法: DELETE

请求路径: /openapi/v1/user

接口描述: 删除用户,仅对私有化开放

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
identityTypestring用户身份类型;
  • email:identityId 为邮箱
  • userId:identityId 为用户 ID
  • sourceId:identityId 为三方(客户)系统唯一的用户 ID(仅私有化)
identityIdstring用户身份ID
forceDeleteboolean是否强制删除;
为 true 的情况下,删除的用户可再次注册

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "userId": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ userIdinteger用户ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

企业

查询资产交接任务状态

请求方法: GET

请求路径: /openapi/v1/assets-transfer-result

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdQueryinteger用户ID,被移除的企业成员 ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "operator": 0,
    "status": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ operatorinteger资产交接操作人ID
  └─ statusinteger任务状态,0: 已提交,1: 进行中,2: 失败,3: 已完成
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取企业信息

请求方法: GET

请求路径: /openapi/v1/organization

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "OrganizationSSOType": 0,
    "abbr": "string",
    "allowPublicDocs": true,
    "allowPublicEmail": true,
    "createAt": "string",
    "creatorId": 0,
    "description": "string",
    "id": 0,
    "isPublic": true,
    "logo": "string",
    "name": "string",
    "openForbidAnonymousAccess": 0,
    "openOrgStructure": true,
    "openOrganizationEmail": 0,
    "openOrganizationSSO": 0,
    "openOrganizationSpace": 0,
    "openSharingTimeLimit": 0,
    "orgStructureName": "string",
    "organFBindOrgEmailizationSaml": 0,
    "organizationEmail": "string",
    "organizationLogin": 0,
    "ownerId": 0,
    "teamJoinApproval": true,
    "updateAt": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ OrganizationSSOTypeintegerSSO类型
  └─ abbrstring企业简称
  └─ allowPublicDocsboolean是否允许文档公开访问
  └─ allowPublicEmailboolean是否允许非企业邮箱注册
  └─ createAtstring创建时间
  └─ creatorIdinteger创建者ID,最初创建者记录
  └─ descriptionstring企业描述
  └─ idintegerID
  └─ isPublicboolean公开邀请链接
  └─ logostring企业logo
  └─ namestring企业名称
  └─ openForbidAnonymousAccessinteger打开禁止匿名访问
  └─ openOrgStructureboolean是否打开企业组织架构
  └─ openOrganizationEmailinteger是否打开企业邮箱
  └─ openOrganizationSSOinteger是否打开SSO
  └─ openOrganizationSpaceinteger打开企业空间, 默认1
  └─ openSharingTimeLimitinteger打开文件分享时间限制
  └─ orgStructureNamestring企业组织架构名称
  └─ organFBindOrgEmailizationSamlinteger是否开启 SAML
  └─ organizationEmailstring企业邮箱域
  └─ organizationLogininteger企业登录方式
  └─ ownerIdinteger拥有者ID,是具有企业最高权限,能转让
  └─ teamJoinApprovalboolean团队邀请是否需要管理员审批
  └─ updateAtstring更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取企业操作日志列表

请求方法: POST

请求路径: /openapi/v1/organization/operation-log/list

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
start_timeinteger开始时间时间戳(秒)
end_timeinteger结束时间时间戳(秒)
page_nointeger页码
page_sizeinteger每页记录数
keywordstring搜索关键字,支持所有用户名和邮箱
teamidsarray<integer>团队ID列表
actionsarray<string>操作类型列表
operatorinteger操作人ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "latestSignIn": "string",
    "operationLogs": [
      {
        "action": "string",
        "actionGroup": "string",
        "actionGroupJoinAction": "string",
        "actionGroupName": "string",
        "actionName": "string",
        "createdAt": "string",
        "description": "string",
        "id": 0,
        "operatorAvatar": "string",
        "operatorEmail": "string",
        "operatorID": 0,
        "operatorIP": "string",
        "operatorName": "string",
        "operatorObject": [0],
        "operatorObjectTeamID": 0,
        "operatorObjectTeamName": "string",
        "operatorType": 0,
        "organizationID": 0
      }
    ],
    "total": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ latestSignInstring最新登录时间
  └─ operationLogsarray<object>操作日志列表
    └─ actionstring操作类型
    └─ actionGroupstring操作组
    └─ actionGroupJoinActionstring操作组关联操作
    └─ actionGroupNamestring操作组名称
    └─ actionNamestring操作名称
    └─ createdAtstring操作时间
    └─ descriptionstring操作描述
    └─ idinteger操作日志ID
    └─ operatorAvatarstring操作人头像
    └─ operatorEmailstring操作人邮箱
    └─ operatorIDinteger操作人ID
    └─ operatorIPstring操作人IP
    └─ operatorNamestring操作人名称
    └─ operatorObjectarray<integer>操作对象
    └─ operatorObjectTeamIDinteger操作对象团队ID
    └─ operatorObjectTeamNamestring操作对象团队名称
    └─ operatorTypeinteger操作人类型
    └─ organizationIDinteger企业ID
  └─ totalinteger总记录数
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

更新企业成员状态

请求方法: PUT

请求路径: /openapi/v1/organization/users/status

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
statusstring状态,enable: 启用,disable: 禁用
userIdsarray<integer>被操作用户ID列表
operatorIdinteger操作人ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

企业成员资产交接

请求方法: DELETE

请求路径: /openapi/v1/orginzation/users

接口描述: 移除企业成员时进行的资产交接操作

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
userIdinteger被移除人ID
operatorinteger操作人ID
receiverIdinteger接收人ID,默认转交给操作人,可以指定企业管理员作为交接人,不可指定为企业成员或访客

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "result": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ resultstring交接任务结果,成功时返回 "commit success"
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

分配席位

请求方法: PUT

请求路径: /openapi/v1/seat/change/batch

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名: userList - 详细划分用户分配的席位,批量给不同的用户分配不同的席位;可以搭配 userIds 和 seatType 进行使用,不互相干扰

类型: 数组<object>

字段名类型必填描述
seatTypestring请参考非数组中的 seatType 参数说明
userIdinteger用户ID
参数名标签类型必填默认值描述
operatorinteger操作人ID
userIdsarray<integer>分配席位用户 ID 列表
seatTypestring分配席位类型,搭配 userIds 进行使用;
给 userIds 中的用户分配对应类型的席位
支持的席位类型有:
  • edit - 设计席位
  • viewAudit - 查看席位(审批)
  • dev - 研发席位
  • prototype - 产品席位

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取企业成员详情信息

请求方法: POST

请求路径: /openapi/v1/team-users

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名: OpenApiOrgUserListRequest - 请求参数

字段名类型必填描述
jobsarray<string>职位,支持多个职位搜索:
* manager - 管理者
* producter - 产品经理
* ui - UI 设计师
* graphic - 平面设计师
* ux - 交互设计师
* developer - 研发工程师
* qa - 测试工程师
* operator - 运营
* freelancer - 自由职业者
* student - 学生
* other - 其他
keywordstring关键字搜索,支持用户名、邮箱和企业组织架构搜索
no_teamboolean不查询团队信息
page_nointeger页码
page_sizeinteger每页记录数
rolesarray<string>角色,owner: 企业创建者,admin: 企业管理员,member: 企业成员,guest: 企业访客
seatsarray<string>席位,支持多个席位搜索,多个席位用逗号分隔
sortstring排序,支持字段为:
* name - 用户名
* job - 职位
* role - 角色
* seat - 席位
* timeActivity - 最后活跃时间
* joinTime - 加入时间
team_idinteger过滤指定团队
user_statusarray<integer>用户状态,0: 正常,1: 禁用
with_last_edit_timeboolean是否返回最后编辑时间

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "total": 0,
    "users_info": [
      {
        "avatar": "string",
        "email": "string",
        "job": "string",
        "name": "string",
        "nickname": "string",
        "orgStructure": "string",
        "role": "string",
        "seat_permission_type": "string",
        "status": 0,
        "teams": [
          {
            "id": 0,
            "name": "string",
            "team_role": "string",
            "user_id": 0
          }
        ],
        "time_activity": "string",
        "time_edit": "string",
        "time_joined_org": "string",
        "uid": 0
      }
    ]
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ totalinteger总记录数
  └─ users_infoarray<object>企业成员详情信息列表
    └─ avatarstring头像
    └─ emailstring邮箱
    └─ jobstring职位
    └─ namestring用户名
    └─ nicknamestring昵称/企业成员名称
    └─ orgStructurestring企业组织架构
    └─ rolestring角色
    └─ seat_permission_typestring席位权限类型
    └─ statusinteger用户状态,0: 正常,1: 禁用
    └─ teamsarray<object>团队信息列表
      └─ idinteger
      └─ namestring
      └─ team_rolestring
      └─ user_idinteger
    └─ time_activitystring最后活跃时间
    └─ time_editstring最后编辑时间
    └─ time_joined_orgstring加入时间
    └─ uidinteger用户ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

团队

获取企业团队列表

请求方法: GET

请求路径: /openapi/v1/organization/teams

接口描述: 获取企业团队列表,可以指定是否包含项目列表

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
withProjectsQueryboolean是否包含项目列表

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "createAt": "string",
      "description": "string",
      "ext": 0,
      "id": 0,
      "logo": "string",
      "name": "string",
      "ownerId": 0,
      "projects": [
        {
          "createAt": "string",
          "id": 0,
          "isPersonal": true,
          "isPublic": 0,
          "name": "string",
          "shareCode": "string",
          "teamId": 0,
          "updateAt": "string",
          "visitControl": 0
        }
      ],
      "updateAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ createAtstring创建时间
    └─ descriptionstring团队描述
    └─ extinteger团队扩展字段
从右至左:
第1位: 为1则是否是公开团队 默认0:不是公开团队
第2位: 为1则是初始化的我的团队
第4位: 为1则是隐藏团队状态 1 隐藏 0 不隐藏
    └─ idintegerID
    └─ logostring团队Logo
    └─ namestring团队名称
    └─ ownerIdinteger团队所有者ID
    └─ projectsarray<object>
      └─ createAtstring创建时间
      └─ idintegerID
      └─ isPersonalboolean是否草稿箱
      └─ isPublicinteger是否公开
      └─ namestring项目名
      └─ shareCodestring分享码
      └─ teamIdinteger团队 ID
      └─ updateAtstring更新时间
      └─ visitControlinteger项目访问范围
    └─ updateAtstring更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

转移团队所有者

请求方法: PUT

请求路径: /openapi/v1/teams/:teamId/owner

接口描述: 转移指定团队所有者到新所有者,两个用户必须都在团队中

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdPathstring团队ID

请求体

参数名标签类型必填默认值描述
oldOwnerIdinteger旧所有者ID
newOwnerIdinteger新所有者ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

创建团队

请求方法: POST

请求路径: /openapi/v1/users/:userId/team

接口描述: 给指定用户创建团队

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头
X-MG-INT-Authentication私有化string集成认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID

请求体

参数名标签类型必填默认值描述
namestring团队名称
descriptionstring团队描述
siteLinkstring团队网站链接
isHiddenboolean是否隐藏团队
sourceId私有化string集成团队来源ID
sourceType私有化string集成团队来源类型

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "createAt": "string",
    "description": "string",
    "ext": 0,
    "id": 0,
    "logo": "string",
    "name": "string",
    "organizationId": 0,
    "ownerId": 0,
    "sourceId": "string",
    "sourceType": "string",
    "updateAt": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ createAtstring创建时间
  └─ descriptionstring团队描述
  └─ extinteger团队扩展字段
从右至左:
第1位: 为1则是否是公开团队 默认0:不是公开团队
第2位: 为1则是初始化的我的团队
第4位: 为1则是隐藏团队状态 1 隐藏 0 不隐藏
  └─ idintegerID
  └─ logostring团队Logo
  └─ namestring团队名称
  └─ organizationIdinteger
  └─ ownerIdinteger团队所有者ID
  └─ sourceIdstring
  └─ sourceTypestring
  └─ updateAtstring更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

更新团队

请求方法: PUT

请求路径: /openapi/v1/users/:userId/team/:teamId

接口描述: 更新指定团队信息,需要指定更新用户

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID
teamIdPathstring团队ID

请求体

参数名标签类型必填默认值描述
namestring团队名称
descriptionstring团队描述
siteLinkstring团队网站链接
logostring团队logo
isHiddenboolean是否隐藏团队

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

删除团队

请求方法: DELETE

请求路径: /openapi/v1/users/:userId/team/:teamId

接口描述: 删除指定团队,需要指定删除用户

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取用户的团队列表

请求方法: GET

请求路径: /openapi/v1/users/:userId/teams

接口描述: 获取指定用户的团队列表,包含【草稿箱团队】

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "createAt": "string",
      "description": "string",
      "ext": 0,
      "id": 0,
      "logo": "string",
      "name": "string",
      "ownerId": 0,
      "updateAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ createAtstring创建时间
    └─ descriptionstring团队描述
    └─ extinteger团队扩展字段
从右至左:
第1位: 为1则是否是公开团队 默认0:不是公开团队
第2位: 为1则是初始化的我的团队
第4位: 为1则是隐藏团队状态 1 隐藏 0 不隐藏
    └─ idintegerID
    └─ logostring团队Logo
    └─ namestring团队名称
    └─ ownerIdinteger团队所有者ID
    └─ updateAtstring更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

项目

批量获取项目信息

请求方法: POST

请求路径: /openapi/v1/projects

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名: ids - 项目ID列表

类型: 数组<integer>

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "createAt": "string",
      "id": 0,
      "isPersonal": true,
      "isPublic": 0,
      "name": "string",
      "shareCode": "string",
      "teamId": 0,
      "updateAt": "string",
      "visitControl": 0
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ createAtstring创建时间
    └─ idintegerID
    └─ isPersonalboolean是否草稿箱
    └─ isPublicinteger是否公开
    └─ namestring项目名
    └─ shareCodestring分享码
    └─ teamIdinteger团队 ID
    └─ updateAtstring更新时间
    └─ visitControlinteger项目访问范围
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取团队下所有项目

请求方法: GET

请求路径: /openapi/v1/team/:teamId/projects

接口描述: 获取指定团队下的所有项目,仅包含基础信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "createAt": "string",
      "id": 0,
      "isPersonal": true,
      "isPublic": 0,
      "name": "string",
      "shareCode": "string",
      "teamId": 0,
      "updateAt": "string",
      "visitControl": 0
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ createAtstring创建时间
    └─ idintegerID
    └─ isPersonalboolean是否草稿箱
    └─ isPublicinteger是否公开
    └─ namestring项目名
    └─ shareCodestring分享码
    └─ teamIdinteger团队 ID
    └─ updateAtstring更新时间
    └─ visitControlinteger项目访问范围
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

创建项目

请求方法: POST

请求路径: /openapi/v1/users/:userId/project

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头
X-MG-INT-Authentication私有化string集成认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID

请求体

参数名标签类型必填默认值描述
teamIdinteger团队ID
namestring项目名称
visitControlnumber1项目的访问范围;
  • 1:当前团队成员可访问
  • 3:仅受邀协作者可访问

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "createAt": "string",
    "id": 0,
    "isPersonal": true,
    "isPublic": 0,
    "name": "string",
    "shareCode": "string",
    "teamId": 0,
    "updateAt": "string",
    "visitControl": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ createAtstring创建时间
  └─ idintegerID
  └─ isPersonalboolean是否草稿箱
  └─ isPublicinteger是否公开
  └─ namestring项目名
  └─ shareCodestring分享码
  └─ teamIdinteger团队 ID
  └─ updateAtstring更新时间
  └─ visitControlinteger项目访问范围
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

更新项目信息

请求方法: PUT

请求路径: /openapi/v1/users/:userId/project/:projectId

接口描述: 更新项目基础息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头
X-MG-INT-Authentication私有化string集成认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID
projectIdPathstring项目ID

请求体

参数名标签类型必填默认值描述
namestring项目名称
visitControlinteger项目的访问范围;项目的访问权限;
  • 1:当前团队成员可访问
  • 3:仅受邀协作者可访问
isPublicboolean是否公开

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "createAt": "string",
    "id": 0,
    "isPersonal": true,
    "isPublic": 0,
    "name": "string",
    "shareCode": "string",
    "teamId": 0,
    "updateAt": "string",
    "visitControl": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ createAtstring创建时间
  └─ idintegerID
  └─ isPersonalboolean是否草稿箱
  └─ isPublicinteger是否公开
  └─ namestring项目名
  └─ shareCodestring分享码
  └─ teamIdinteger团队 ID
  └─ updateAtstring更新时间
  └─ visitControlinteger项目访问范围
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

删除项目

请求方法: DELETE

请求路径: /openapi/v1/users/:userId/project/:projectId

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头
X-MG-INT-Authentication私有化string集成认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID
projectIdPathstring项目ID

请求体

参数名: teamId - 团队ID

类型: integer

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取用户在团队下的项目列表

请求方法: GET

请求路径: /openapi/v1/users/:userId/projects

接口描述: 获取用户在团队下的项目列表,仅包含基础信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdQuerystring团队ID
userIdPathstring用户ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "createdAt": "string",
      "id": 0,
      "name": "string",
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ createdAtstring创建时间
    └─ idinteger项目ID
    └─ namestring项目名称
    └─ updatedAtstring更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取用户所有可访问的项目

请求方法: POST

请求路径: /openapi/v1/users/:userId/projects/accessible

接口描述: 分页获取用户所有可访问的项目列表,仅包含基础信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID

请求体

参数名标签类型必填默认值描述
keywordstring关键词,用于搜索项目名
sortstring-updated_at排序字段;
支持 name, created_at, updated_at;
默认 -updated_at
numberinteger1当前页数,从1开始
sizeinteger20每页大小

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "createdAt": "string",
      "id": 0,
      "isPersonal": true,
      "name": "string",
      "updatedAt": "string"
    }
  ],
  "meta": {
    "page": {
      "total": 0
    },
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ createdAtstring创建时间
    └─ idinteger项目ID
    └─ isPersonalboolean是否为草稿箱
    └─ namestring项目名称
    └─ updatedAtstring更新时间
metaobject
  └─ pageobject分页信息
    └─ totalinteger总条数
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

文件

移动文档所属项目

请求方法: PUT

请求路径: /openapi/v1/document/:userId/document-move

接口描述: 移动文档所属项目,仅支持同团队内移动

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
documentIdinteger文件ID
destProjectIdinteger目标项目ID,需要填写当前文件所属团队下的项目 ID,否则移动失败

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "documentId": 0,
    "projectId": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ documentIdinteger文件ID
  └─ projectIdinteger移动后的项目ID
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

创建文件副本

请求方法: POST

请求路径: /openapi/v1/document/copy

接口描述: 创建文件副本,创建出的副本文件所有者为原文件所有者

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名标签类型必填默认值描述
documentIdinteger文件ID
versionIdinteger版本号
projectIdinteger项目ID,指定副本创建到的项目

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "allowCopy": true,
    "allowCopyRole": "string",
    "cover": "string",
    "coverBgColor": "string",
    "createAt": "string",
    "creatorId": 0,
    "fileMode": 0,
    "id": 0,
    "name": "string",
    "ownerId": 0,
    "projectId": 0,
    "teamId": 0,
    "updateAt": "string",
    "updateUserId": 0,
    "visitControl": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ allowCopyboolean是否允许复制
  └─ allowCopyRolestring允许复制角色
  └─ coverstring文档封面
  └─ coverBgColorstring文档封面背景颜色
  └─ createAtstring创建时间
  └─ creatorIdinteger创建者ID
  └─ fileModeinteger文档模式
0:设计文件
1:原型文件
  └─ idintegerID
  └─ namestring文档名称
  └─ ownerIdinteger文件所有者ID
  └─ projectIdinteger项目ID
  └─ teamIdinteger团队ID
  └─ updateAtstring更新时间
  └─ updateUserIdinteger更新者ID
  └─ visitControlinteger文件访问范围
1-当前团队成员可访问 2-当前企业成员可访问 3-仅受邀协作者可访问
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

批量获取文件信息

请求方法: POST

请求路径: /openapi/v1/documents

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名: ids - 文件ID列表

类型: 数组<integer>

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "allowCopy": true,
      "allowCopyRole": "string",
      "cover": "string",
      "coverBgColor": "string",
      "createAt": "string",
      "creatorId": 0,
      "fileMode": 0,
      "id": 0,
      "name": "string",
      "ownerId": 0,
      "projectId": 0,
      "teamId": 0,
      "updateAt": "string",
      "updateUserId": 0,
      "visitControl": 0
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ allowCopyboolean是否允许复制
    └─ allowCopyRolestring允许复制角色
    └─ coverstring文档封面
    └─ coverBgColorstring文档封面背景颜色
    └─ createAtstring创建时间
    └─ creatorIdinteger创建者ID
    └─ fileModeinteger文档模式
0:设计文件
1:原型文件
    └─ idintegerID
    └─ namestring文档名称
    └─ ownerIdinteger文件所有者ID
    └─ projectIdinteger项目ID
    └─ teamIdinteger团队ID
    └─ updateAtstring更新时间
    └─ updateUserIdinteger更新者ID
    └─ visitControlinteger文件访问范围
1-当前团队成员可访问 2-当前企业成员可访问 3-仅受邀协作者可访问
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

筛选项目下文件

请求方法: GET

请求路径: /openapi/v1/project/:projectId/documents

接口描述: 分页获取指定项目下的文件,支持搜索、排序、分页

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
keywordQuerystring搜索关键词
sortQuerystring-updated_at排序字段
支持 name, created_at, updated_at
page[number]Queryinteger当前页数,从1开始
page[size]Queryinteger每页大小
projectIdPathstring项目ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "coverBgColor": "string",
      "createdAt": "string",
      "creatorId": 0,
      "fileMode": 0,
      "id": 0,
      "name": "string",
      "ownerId": 0,
      "type": 0,
      "updatedAt": "string"
    }
  ],
  "meta": {
    "page": {
      "total": 0
    },
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring文件封面
    └─ coverBgColorstring文件封面背景颜色
    └─ createdAtstring创建时间
    └─ creatorIdinteger创建者ID
    └─ fileModeinteger文件模式; 0 设计文件,1 原型文件
    └─ idinteger文件ID
    └─ namestring文件名称
    └─ ownerIdinteger文件所有者ID
    └─ typeinteger文件类型
    └─ updatedAtstring更新时间
metaobject
  └─ pageobject分页信息
    └─ totalinteger总条数
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取项目下已发布为团队库的文件

请求方法: GET

请求路径: /openapi/v1/project/:projectId/lib/documents

接口描述: 获取指定项目下已发布为团队库的文件信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
projectIdPathstring项目ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "createdAt": "string",
      "creatorId": 0,
      "fileMode": 0,
      "id": 0,
      "libraryId": "string",
      "name": "string",
      "ownerId": 0,
      "type": 0,
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ createdAtstring创建时间
    └─ creatorIdinteger创建者ID
    └─ fileModeinteger文件模式; 0 设计文件,1 原型文件
    └─ idinteger文件ID
    └─ libraryIdstring团队库ID
    └─ namestring文件名称
    └─ ownerIdinteger文件所有者ID
    └─ typeinteger文件类型
    └─ updatedAtstring更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

根据文件名搜索文件

请求方法: GET

请求路径: /openapi/v1/searchDocs

接口描述: 根据文档名模糊搜索文档,可以指定搜索范围为团队、项目、所有者

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
keyQuerystring关键词
teamIdQuerystring文件所属团队ID
projectIdQuerystring文件所属项目ID
userIdQuerystring文件所属用户ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "id": 0,
      "name": "string",
      "owner_Id": 0,
      "updated_at": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring文件封面
    └─ idinteger文件ID
    └─ namestring文件名称
    └─ owner_Idinteger文件所有者ID
    └─ updated_atstring文件更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

筛选团队下文件

请求方法: GET

请求路径: /openapi/v1/team/:teamId/documents

接口描述: 获取指定团队下的文件,支持搜索、排序、分页,仅包含基础信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头
X-MG-INT-Authentication私有化string集成认证头

参数

参数名标签位置类型必填默认值描述
keywordQuerystring文件名搜索关键词
sortQuerystring-updated_at排序字段
支持 name, created_at, updated_at
pageNumQueryinteger当前页数,从1开始
pageSizeQueryinteger每页大小
userIdQueryinteger用户ID,非必需参数;
当传入时,会返回该用户对团队下文件的部分权限信息
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "coverBgColor": "string",
      "createdAt": "string",
      "creatorId": 0,
      "fileMode": 0,
      "id": 0,
      "isTeamLib": true,
      "name": "string",
      "ownerId": 0,
      "permissions": {},
      "sourceId": "string",
      "type": 0,
      "updatedAt": "string"
    }
  ],
  "meta": {
    "page": {
      "total": 0
    },
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring文件封面
    └─ coverBgColorstring文件封面背景颜色
    └─ createdAtstring创建时间
    └─ creatorIdinteger创建者ID
    └─ fileModeinteger文件模式; 0 设计文件,1 原型文件
    └─ idinteger文件ID
    └─ isTeamLibboolean是否为团队库文件
    └─ namestring文件名称
    └─ ownerIdinteger文件所有者ID
    └─ permissionsobject文件权限
    └─ sourceIdstring所有者三方 ID(仅私有化集成返回)
    └─ typeinteger文件类型
    └─ updatedAtstring更新时间
metaobject
  └─ pageobject分页信息
    └─ totalinteger总条数
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取团队下已发布为团队库的文件

请求方法: GET

请求路径: /openapi/v1/team/:teamId/lib/documents

接口描述: 获取指定团队下已发布为团队库的文件信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "createdAt": "string",
      "creatorId": 0,
      "fileMode": 0,
      "id": 0,
      "libraryId": "string",
      "name": "string",
      "ownerId": 0,
      "type": 0,
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ createdAtstring创建时间
    └─ creatorIdinteger创建者ID
    └─ fileModeinteger文件模式; 0 设计文件,1 原型文件
    └─ idinteger文件ID
    └─ libraryIdstring团队库ID
    └─ namestring文件名称
    └─ ownerIdinteger文件所有者ID
    └─ typeinteger文件类型
    └─ updatedAtstring更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取团队回收站文件列表

请求方法: GET

请求路径: /openapi/v1/team/:teamId/recycle-bins

接口描述: 获取指定团队下的回收站文件列表,支持搜索、排序、分页,仅包含基础信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdQueryinteger用户ID
page[number]Queryinteger1当前页数,从1开始
page[size]Queryinteger20每页大小
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "documents": [
      {
        "createdAt": "string",
        "creatorId": 0,
        "deleteSourceId": "string",
        "deleteUserId": 0,
        "fileMode": 0,
        "id": 0,
        "name": "string",
        "ownerId": 0,
        "permissions": {},
        "type": 0,
        "updatedAt": "string"
      }
    ],
    "total": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ documentsarray<object>
    └─ createdAtstring创建时间
    └─ creatorIdinteger创建者ID
    └─ deleteSourceIdstring删除者三方 ID(仅私有化集成返回)
    └─ deleteUserIdinteger删除者ID
    └─ fileModeinteger文件模式; 0 设计文件,1 原型文件
    └─ idinteger文件ID
    └─ namestring文件名称
    └─ ownerIdinteger文件所有者ID
    └─ permissionsobject文件永久删除和恢复权限
    └─ typeinteger文件类型
    └─ updatedAtstring更新时间
  └─ totalinteger总记录数
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

创建文档

请求方法: POST

请求路径: /openapi/v1/users/:userId/document

接口描述: 创建文档,需要指定创建用户

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID,文件所有者

请求体

参数名标签类型必填默认值描述
projectIdinteger项目ID,当不传入时,默认创建到用户的草稿箱中
namestring文档名称
fileModeinteger0文档模式
0:设计文件
1:原型文件

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "allowCopy": true,
    "allowCopyRole": "string",
    "cover": "string",
    "coverBgColor": "string",
    "createAt": "string",
    "creatorId": 0,
    "fileMode": 0,
    "id": 0,
    "name": "string",
    "ownerId": 0,
    "projectId": 0,
    "teamId": 0,
    "updateAt": "string",
    "updateUserId": 0,
    "visitControl": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ allowCopyboolean是否允许复制
  └─ allowCopyRolestring允许复制角色
  └─ coverstring文档封面
  └─ coverBgColorstring文档封面背景颜色
  └─ createAtstring创建时间
  └─ creatorIdinteger创建者ID
  └─ fileModeinteger文档模式
0:设计文件
1:原型文件
  └─ idintegerID
  └─ namestring文档名称
  └─ ownerIdinteger文件所有者ID
  └─ projectIdinteger项目ID
  └─ teamIdinteger团队ID
  └─ updateAtstring更新时间
  └─ updateUserIdinteger更新者ID
  └─ visitControlinteger文件访问范围
1-当前团队成员可访问 2-当前企业成员可访问 3-仅受邀协作者可访问
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

删除文档

请求方法: DELETE

请求路径: /openapi/v1/users/:userId/document

接口描述: 删除指定文档,需要指定删除用户

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
documentIdQuerystring文档ID
userIdPathstring用户ID,文件所有者

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

更新文件

请求方法: PUT

请求路径: /openapi/v1/users/:userId/document/:documentId

接口描述: 更新文件,需要指定更新用户

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID,文件所有者
documentIdPathstring文档ID

请求体

参数名标签类型必填默认值描述
isPublicboolean是否公开
allowCopyboolean是否允许复制
allowOnlookerCopyboolean是否允许查看者复制文件
coverstring封面
coverBgColorstring封面背景颜色
namestring文档名称
versionIdinteger版本号
visitControlinteger文件访问范围
1-当前团队成员可访问 2-当前企业成员可访问 3-仅受邀协作者可访问

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取用户在项目下的文档列表

请求方法: GET

请求路径: /openapi/v1/users/:userId/documents

接口描述: 分页获取用户在项目下的文档列表

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
projectIdQuerystring项目ID
userIdPathstring用户ID

请求体

参数名标签类型必填默认值描述
keywordstring关键词,用于搜索文档名
sortstring-updated_at排序字段
支持 name, created_at, updated_at
numberinteger1当前页数,从1开始
sizeinteger20每页大小

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "coverBgColor": "string",
      "createdAt": "string",
      "fileMode": 0,
      "id": 0,
      "name": "string",
      "ownerId": 0,
      "type": 0,
      "updatedAt": "string"
    }
  ],
  "meta": {
    "page": {
      "total": 0
    },
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring文件封面
    └─ coverBgColorstring文件封面背景颜色
    └─ createdAtstring创建时间
    └─ fileModeinteger文件模式
0:设计文件
1:原型文件
    └─ idinteger文件ID
    └─ namestring文件名称
    └─ ownerIdinteger文件所有者ID
    └─ typeinteger文件类型
    └─ updatedAtstring更新时间
metaobject
  └─ pageobject分页信息
    └─ totalinteger总条数
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

从回收站恢复文件

请求方法: PUT

请求路径: /openapi/v1/users/:userId/team/:teamId/recycle-bins

接口描述: 恢复指定团队回收站中删除的文件,需要指定恢复用户

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID
teamIdPathstring团队ID

请求体

参数名标签类型必填默认值描述
documentIdsarray<integer>文件ID列表
targetProjectIdinteger目标项目ID;
若指定则回收站文件可以恢复到指定项目下
若不指定则恢复到文件所属的原项目下

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

永久删除回收站中的文件

请求方法: DELETE

请求路径: /openapi/v1/users/:userId/team/:teamId/recycle-bins

接口描述: 永久删除指定团队回收站中删除的文件,需要指定删除用户,请谨慎操作

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID
teamIdPathstring团队ID

请求体

参数名: documentIds - 文件ID列表

类型: 数组<integer>

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 获取文件资源预览信息

请求方法: GET

请求路径: /openapi/v1/resource/preview

接口描述: 获取文件资源预览信息(预览链接),仅对私有化开放

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
documentIdQuerystring文档ID
fullScreenQueryboolean是否可以全屏

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "previewUrl": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ previewUrlstring文件资源预览链接
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

审批

Beta 审批申请

请求方法: POST

请求路径: /openapi/v1/applies/:applyId/approval

接口描述: 审批文件编辑权限、席位申请等申请信息

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
applyIdPathinteger申请ID

请求体

参数名标签类型必填默认值描述
statusstring审批状态
支持参数:accepted - 通过, denied - 拒绝
namestring审批人名称
reasonstring审批理由

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

团队库

获取指定组件详情

请求方法: GET

请求路径: /openapi/v1/component

接口描述: 根据组件唯一 key 获取指定组件的详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
ukeyQuerystring组件唯一 key;
获取方式请查看文档中【团队库】中相关接口详情

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "componentSetUkey": "string",
    "cover": "string",
    "createdAt": "string",
    "description": "string",
    "documentId": 0,
    "height": 0.0,
    "lastUpdator": {
      "avatar": "string",
      "id": 0,
      "name": "string"
    },
    "layerId": "string",
    "name": "string",
    "pageInfo": {
      "backgroundColor": "string",
      "frameName": "string",
      "layerId": "string",
      "pageId": "string",
      "pageName": "string"
    },
    "type": "string",
    "ukey": "string",
    "updatedAt": "string",
    "width": 0.0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ componentSetUkeystring组件所属组件集 UKey
  └─ coverstring组件封面
  └─ createdAtstring组件创建时间
  └─ descriptionstring组件描述
  └─ documentIdinteger组件所属文档 ID
  └─ heightnumber组件高度
  └─ lastUpdatorobject组件最后更新人信息
    └─ avatarstring用户头像
    └─ idinteger用户 ID
    └─ namestring用户名
  └─ layerIdstring组件所属图层 ID
  └─ namestring组件名称
  └─ pageInfoobject组件页面信息
    └─ backgroundColorstring背景颜色
    └─ frameNamestring容器名称
    └─ layerIdstring图层 ID
    └─ pageIdstring页面 ID
    └─ pageNamestring页面名称
  └─ typestring组件类型
  └─ ukeystring组件 UKey (唯一)
  └─ updatedAtstring组件更新时间
  └─ widthnumber组件宽度
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取指定组件集详情

请求方法: GET

请求路径: /openapi/v1/componentSet

接口描述: 根据组件集唯一 key 获取指定组件集的详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
ukeyQuerystring组件集唯一 key;
获取方式请查看文档中【团队库】中相关接口详情

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "cover": "string",
    "createdAt": "string",
    "description": "string",
    "documentId": 0,
    "lastUpdator": {
      "avatar": "string",
      "id": 0,
      "name": "string"
    },
    "layerId": "string",
    "name": "string",
    "pageInfo": {
      "backgroundColor": "string",
      "frameName": "string",
      "layerId": "string",
      "pageId": "string",
      "pageName": "string"
    },
    "ukey": "string",
    "updatedAt": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ coverstring组件集封面
  └─ createdAtstring组件集创建时间
  └─ descriptionstring组件集描述
  └─ documentIdinteger组件集所属文档 ID
  └─ lastUpdatorobject组件集最后更新人信息
    └─ avatarstring用户头像
    └─ idinteger用户 ID
    └─ namestring用户名
  └─ layerIdstring组件集所属图层 ID
  └─ namestring组件集名称
  └─ pageInfoobject组件集页面信息
    └─ backgroundColorstring背景颜色
    └─ frameNamestring容器名称
    └─ layerIdstring图层 ID
    └─ pageIdstring页面 ID
    └─ pageNamestring页面名称
  └─ ukeystring组件集 UKey (唯一)
  └─ updatedAtstring组件集更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取文件下已发布的组件集详情

请求方法: GET

请求路径: /openapi/v1/document/:documentId/componentSets

接口描述: 获取指定文件下所有已经发布团队库的组件集详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
documentIdPathstring文件ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "createdAt": "string",
      "description": "string",
      "documentId": 0,
      "lastUpdator": {
        "avatar": "string",
        "id": 0,
        "name": "string"
      },
      "layerId": "string",
      "name": "string",
      "pageInfo": {
        "backgroundColor": "string",
        "frameName": "string",
        "layerId": "string",
        "pageId": "string",
        "pageName": "string"
      },
      "ukey": "string",
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring组件集封面
    └─ createdAtstring组件集创建时间
    └─ descriptionstring组件集描述
    └─ documentIdinteger组件集所属文档 ID
    └─ lastUpdatorobject组件集最后更新人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ layerIdstring组件集所属图层 ID
    └─ namestring组件集名称
    └─ pageInfoobject组件集页面信息
      └─ backgroundColorstring背景颜色
      └─ frameNamestring容器名称
      └─ layerIdstring图层 ID
      └─ pageIdstring页面 ID
      └─ pageNamestring页面名称
    └─ ukeystring组件集 UKey (唯一)
    └─ updatedAtstring组件集更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取文件下已经发布的组件详情

请求方法: GET

请求路径: /openapi/v1/document/:documentId/components

接口描述: 获取指定文件下已经发布的组件详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
documentIdPathstring文件ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "componentSetUkey": "string",
      "cover": "string",
      "createdAt": "string",
      "description": "string",
      "documentId": 0,
      "height": 0.0,
      "lastUpdator": {
        "avatar": "string",
        "id": 0,
        "name": "string"
      },
      "layerId": "string",
      "name": "string",
      "pageInfo": {
        "backgroundColor": "string",
        "frameName": "string",
        "layerId": "string",
        "pageId": "string",
        "pageName": "string"
      },
      "type": "string",
      "ukey": "string",
      "updatedAt": "string",
      "width": 0.0
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ componentSetUkeystring组件所属组件集 UKey
    └─ coverstring组件封面
    └─ createdAtstring组件创建时间
    └─ descriptionstring组件描述
    └─ documentIdinteger组件所属文档 ID
    └─ heightnumber组件高度
    └─ lastUpdatorobject组件最后更新人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ layerIdstring组件所属图层 ID
    └─ namestring组件名称
    └─ pageInfoobject组件页面信息
      └─ backgroundColorstring背景颜色
      └─ frameNamestring容器名称
      └─ layerIdstring图层 ID
      └─ pageIdstring页面 ID
      └─ pageNamestring页面名称
    └─ typestring组件类型
    └─ ukeystring组件 UKey (唯一)
    └─ updatedAtstring组件更新时间
    └─ widthnumber组件宽度
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取文件下所有已发布的内容

请求方法: GET

请求路径: /openapi/v1/document/:documentId/library

接口描述: 获取指定文件下所有已经发布的团队库内容

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
documentIdPathstring文件ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "componentSets": [
        {
          "cover": "string",
          "createdAt": "string",
          "description": "string",
          "documentId": 0,
          "lastUpdator": {
            "avatar": "string",
            "id": 0,
            "name": "string"
          },
          "layerId": "string",
          "name": "string",
          "pageInfo": {
            "backgroundColor": "string",
            "frameName": "string",
            "layerId": "string",
            "pageId": "string",
            "pageName": "string"
          },
          "ukey": "string",
          "updatedAt": "string"
        }
      ],
      "components": [
        {
          "componentSetUkey": "string",
          "cover": "string",
          "createdAt": "string",
          "description": "string",
          "documentId": 0,
          "height": 0.0,
          "lastUpdator": {
            "avatar": "string",
            "id": 0,
            "name": "string"
          },
          "layerId": "string",
          "name": "string",
          "pageInfo": {
            "backgroundColor": "string",
            "frameName": "string",
            "layerId": "string",
            "pageId": "string",
            "pageName": "string"
          },
          "type": "string",
          "ukey": "string",
          "updatedAt": "string",
          "width": 0.0
        }
      ],
      "createdAt": "string",
      "creator": {
        "avatar": "string",
        "id": 0,
        "name": "string"
      },
      "documentId": 0,
      "documentName": "string",
      "id": "string",
      "projectId": 0,
      "publishedScope": "string",
      "styles": [
        {
          "cover": "string",
          "createdAt": "string",
          "description": "string",
          "documentId": 0,
          "lastUpdator": {
            "avatar": "string",
            "id": 0,
            "name": "string"
          },
          "name": "string",
          "sortIndex": "string",
          "styleSubType": 0,
          "styleType": "string",
          "ukey": "string",
          "updatedAt": "string"
        }
      ],
      "teamId": 0,
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ componentSetsarray<object>团队库组件集列表
      └─ coverstring组件集封面
      └─ createdAtstring组件集创建时间
      └─ descriptionstring组件集描述
      └─ documentIdinteger组件集所属文档 ID
      └─ lastUpdatorobject组件集最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ layerIdstring组件集所属图层 ID
      └─ namestring组件集名称
      └─ pageInfoobject组件集页面信息
        └─ backgroundColorstring背景颜色
        └─ frameNamestring容器名称
        └─ layerIdstring图层 ID
        └─ pageIdstring页面 ID
        └─ pageNamestring页面名称
      └─ ukeystring组件集 UKey (唯一)
      └─ updatedAtstring组件集更新时间
    └─ componentsarray<object>团队库组件列表
      └─ componentSetUkeystring组件所属组件集 UKey
      └─ coverstring组件封面
      └─ createdAtstring组件创建时间
      └─ descriptionstring组件描述
      └─ documentIdinteger组件所属文档 ID
      └─ heightnumber组件高度
      └─ lastUpdatorobject组件最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ layerIdstring组件所属图层 ID
      └─ namestring组件名称
      └─ pageInfoobject组件页面信息
        └─ backgroundColorstring背景颜色
        └─ frameNamestring容器名称
        └─ layerIdstring图层 ID
        └─ pageIdstring页面 ID
        └─ pageNamestring页面名称
      └─ typestring组件类型
      └─ ukeystring组件 UKey (唯一)
      └─ updatedAtstring组件更新时间
      └─ widthnumber组件宽度
    └─ createdAtstring团队库创建时间
    └─ creatorobject团队库创建人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ documentIdinteger团队库文件 ID
    └─ documentNamestring团队库文件名称
    └─ idstring团队库 ID
    └─ projectIdinteger团队库所属项目 ID
    └─ publishedScopestring团队库发布范围
    └─ stylesarray<object>团队库样式列表
      └─ coverstring样式封面
      └─ createdAtstring样式创建时间
      └─ descriptionstring样式描述
      └─ documentIdinteger样式所属文档 ID
      └─ lastUpdatorobject样式最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ namestring样式名称
      └─ sortIndexstring样式子类型
      └─ styleSubTypeinteger样式子类型
      └─ styleTypestring样式类型
      └─ ukeystring样式 UKey (唯一)
      └─ updatedAtstring样式更新时间
    └─ teamIdinteger团队库所属团队 ID
    └─ updatedAtstring团队库更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取文件下已发布的样式详情

请求方法: GET

请求路径: /openapi/v1/document/:documentId/styles

接口描述: 获取指定文件下所有已经发布团队库的样式详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
documentIdPathstring文件ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "createdAt": "string",
      "description": "string",
      "documentId": 0,
      "lastUpdator": {
        "avatar": "string",
        "id": 0,
        "name": "string"
      },
      "name": "string",
      "sortIndex": "string",
      "styleSubType": 0,
      "styleType": "string",
      "ukey": "string",
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring样式封面
    └─ createdAtstring样式创建时间
    └─ descriptionstring样式描述
    └─ documentIdinteger样式所属文档 ID
    └─ lastUpdatorobject样式最后更新人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ namestring样式名称
    └─ sortIndexstring样式子类型
    └─ styleSubTypeinteger样式子类型
    └─ styleTypestring样式类型
    └─ ukeystring样式 UKey (唯一)
    └─ updatedAtstring样式更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取指定样式详情

请求方法: GET

请求路径: /openapi/v1/style

接口描述: 根据样式唯一 key 获取指定样式的详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
ukeyQuerystring样式唯一 key;
获取方式请查看文档中【团队库】中相关接口详情

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "cover": "string",
    "createdAt": "string",
    "description": "string",
    "documentId": 0,
    "lastUpdator": {
      "avatar": "string",
      "id": 0,
      "name": "string"
    },
    "name": "string",
    "sortIndex": "string",
    "styleSubType": 0,
    "styleType": "string",
    "ukey": "string",
    "updatedAt": "string"
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ coverstring样式封面
  └─ createdAtstring样式创建时间
  └─ descriptionstring样式描述
  └─ documentIdinteger样式所属文档 ID
  └─ lastUpdatorobject样式最后更新人信息
    └─ avatarstring用户头像
    └─ idinteger用户 ID
    └─ namestring用户名
  └─ namestring样式名称
  └─ sortIndexstring样式子类型
  └─ styleSubTypeinteger样式子类型
  └─ styleTypestring样式类型
  └─ ukeystring样式 UKey (唯一)
  └─ updatedAtstring样式更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取团队下已发布的组件集详情

请求方法: GET

请求路径: /openapi/v1/team/:teamId/componentSets

接口描述: 获取指定团队下所有已经发布团队库的组件集详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "createdAt": "string",
      "description": "string",
      "documentId": 0,
      "lastUpdator": {
        "avatar": "string",
        "id": 0,
        "name": "string"
      },
      "layerId": "string",
      "name": "string",
      "pageInfo": {
        "backgroundColor": "string",
        "frameName": "string",
        "layerId": "string",
        "pageId": "string",
        "pageName": "string"
      },
      "ukey": "string",
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring组件集封面
    └─ createdAtstring组件集创建时间
    └─ descriptionstring组件集描述
    └─ documentIdinteger组件集所属文档 ID
    └─ lastUpdatorobject组件集最后更新人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ layerIdstring组件集所属图层 ID
    └─ namestring组件集名称
    └─ pageInfoobject组件集页面信息
      └─ backgroundColorstring背景颜色
      └─ frameNamestring容器名称
      └─ layerIdstring图层 ID
      └─ pageIdstring页面 ID
      └─ pageNamestring页面名称
    └─ ukeystring组件集 UKey (唯一)
    └─ updatedAtstring组件集更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取团队下所有已发布组件详情

请求方法: GET

请求路径: /openapi/v1/team/:teamId/components

接口描述: 获取指定团队下所有已经发布团队库的组件详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "componentSetUkey": "string",
      "cover": "string",
      "createdAt": "string",
      "description": "string",
      "documentId": 0,
      "height": 0.0,
      "lastUpdator": {
        "avatar": "string",
        "id": 0,
        "name": "string"
      },
      "layerId": "string",
      "name": "string",
      "pageInfo": {
        "backgroundColor": "string",
        "frameName": "string",
        "layerId": "string",
        "pageId": "string",
        "pageName": "string"
      },
      "type": "string",
      "ukey": "string",
      "updatedAt": "string",
      "width": 0.0
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ componentSetUkeystring组件所属组件集 UKey
    └─ coverstring组件封面
    └─ createdAtstring组件创建时间
    └─ descriptionstring组件描述
    └─ documentIdinteger组件所属文档 ID
    └─ heightnumber组件高度
    └─ lastUpdatorobject组件最后更新人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ layerIdstring组件所属图层 ID
    └─ namestring组件名称
    └─ pageInfoobject组件页面信息
      └─ backgroundColorstring背景颜色
      └─ frameNamestring容器名称
      └─ layerIdstring图层 ID
      └─ pageIdstring页面 ID
      └─ pageNamestring页面名称
    └─ typestring组件类型
    └─ ukeystring组件 UKey (唯一)
    └─ updatedAtstring组件更新时间
    └─ widthnumber组件宽度
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取团队下所有已发布的内容

请求方法: GET

请求路径: /openapi/v1/team/:teamId/libraries

接口描述: 获取指定团队下所有已经发布的团队库内容

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "componentSets": [
        {
          "cover": "string",
          "createdAt": "string",
          "description": "string",
          "documentId": 0,
          "lastUpdator": {
            "avatar": "string",
            "id": 0,
            "name": "string"
          },
          "layerId": "string",
          "name": "string",
          "pageInfo": {
            "backgroundColor": "string",
            "frameName": "string",
            "layerId": "string",
            "pageId": "string",
            "pageName": "string"
          },
          "ukey": "string",
          "updatedAt": "string"
        }
      ],
      "components": [
        {
          "componentSetUkey": "string",
          "cover": "string",
          "createdAt": "string",
          "description": "string",
          "documentId": 0,
          "height": 0.0,
          "lastUpdator": {
            "avatar": "string",
            "id": 0,
            "name": "string"
          },
          "layerId": "string",
          "name": "string",
          "pageInfo": {
            "backgroundColor": "string",
            "frameName": "string",
            "layerId": "string",
            "pageId": "string",
            "pageName": "string"
          },
          "type": "string",
          "ukey": "string",
          "updatedAt": "string",
          "width": 0.0
        }
      ],
      "createdAt": "string",
      "creator": {
        "avatar": "string",
        "id": 0,
        "name": "string"
      },
      "documentId": 0,
      "documentName": "string",
      "id": "string",
      "projectId": 0,
      "publishedScope": "string",
      "styles": [
        {
          "cover": "string",
          "createdAt": "string",
          "description": "string",
          "documentId": 0,
          "lastUpdator": {
            "avatar": "string",
            "id": 0,
            "name": "string"
          },
          "name": "string",
          "sortIndex": "string",
          "styleSubType": 0,
          "styleType": "string",
          "ukey": "string",
          "updatedAt": "string"
        }
      ],
      "teamId": 0,
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ componentSetsarray<object>团队库组件集列表
      └─ coverstring组件集封面
      └─ createdAtstring组件集创建时间
      └─ descriptionstring组件集描述
      └─ documentIdinteger组件集所属文档 ID
      └─ lastUpdatorobject组件集最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ layerIdstring组件集所属图层 ID
      └─ namestring组件集名称
      └─ pageInfoobject组件集页面信息
        └─ backgroundColorstring背景颜色
        └─ frameNamestring容器名称
        └─ layerIdstring图层 ID
        └─ pageIdstring页面 ID
        └─ pageNamestring页面名称
      └─ ukeystring组件集 UKey (唯一)
      └─ updatedAtstring组件集更新时间
    └─ componentsarray<object>团队库组件列表
      └─ componentSetUkeystring组件所属组件集 UKey
      └─ coverstring组件封面
      └─ createdAtstring组件创建时间
      └─ descriptionstring组件描述
      └─ documentIdinteger组件所属文档 ID
      └─ heightnumber组件高度
      └─ lastUpdatorobject组件最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ layerIdstring组件所属图层 ID
      └─ namestring组件名称
      └─ pageInfoobject组件页面信息
        └─ backgroundColorstring背景颜色
        └─ frameNamestring容器名称
        └─ layerIdstring图层 ID
        └─ pageIdstring页面 ID
        └─ pageNamestring页面名称
      └─ typestring组件类型
      └─ ukeystring组件 UKey (唯一)
      └─ updatedAtstring组件更新时间
      └─ widthnumber组件宽度
    └─ createdAtstring团队库创建时间
    └─ creatorobject团队库创建人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ documentIdinteger团队库文件 ID
    └─ documentNamestring团队库文件名称
    └─ idstring团队库 ID
    └─ projectIdinteger团队库所属项目 ID
    └─ publishedScopestring团队库发布范围
    └─ stylesarray<object>团队库样式列表
      └─ coverstring样式封面
      └─ createdAtstring样式创建时间
      └─ descriptionstring样式描述
      └─ documentIdinteger样式所属文档 ID
      └─ lastUpdatorobject样式最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ namestring样式名称
      └─ sortIndexstring样式子类型
      └─ styleSubTypeinteger样式子类型
      └─ styleTypestring样式类型
      └─ ukeystring样式 UKey (唯一)
      └─ updatedAtstring样式更新时间
    └─ teamIdinteger团队库所属团队 ID
    └─ updatedAtstring团队库更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

获取团队下已发布的样式详情

请求方法: GET

请求路径: /openapi/v1/team/:teamId/styles

接口描述: 获取指定团队下所有已经发布团队库的样式详情

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "createdAt": "string",
      "description": "string",
      "documentId": 0,
      "lastUpdator": {
        "avatar": "string",
        "id": 0,
        "name": "string"
      },
      "name": "string",
      "sortIndex": "string",
      "styleSubType": 0,
      "styleType": "string",
      "ukey": "string",
      "updatedAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring样式封面
    └─ createdAtstring样式创建时间
    └─ descriptionstring样式描述
    └─ documentIdinteger样式所属文档 ID
    └─ lastUpdatorobject样式最后更新人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ namestring样式名称
    └─ sortIndexstring样式子类型
    └─ styleSubTypeinteger样式子类型
    └─ styleTypestring样式类型
    └─ ukeystring样式 UKey (唯一)
    └─ updatedAtstring样式更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 获取文件中所有订阅的组件库详情

请求方法: GET

请求路径: /openapi/v1/document/:documentId/subscribeTeamLibraries/detail

接口描述: 获取文件中所有订阅的组件库详情,仅对私有化开放

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
withPresetLibQueryboolean是否包含预制团队库
documentIdPathstring文档ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "teamLibrary": [
      {
        "componentSets": [
          {
            "cover": "string",
            "createdAt": "string",
            "description": "string",
            "documentId": 0,
            "lastUpdator": {
              "avatar": "string",
              "id": 0,
              "name": "string"
            },
            "layerId": "string",
            "name": "string",
            "pageInfo": {
              "backgroundColor": "string",
              "frameName": "string",
              "layerId": "string",
              "pageId": "string",
              "pageName": "string"
            },
            "ukey": "string",
            "updatedAt": "string"
          }
        ],
        "components": [
          {
            "componentSetUkey": "string",
            "cover": "string",
            "createdAt": "string",
            "description": "string",
            "documentId": 0,
            "height": 0.0,
            "lastUpdator": {
              "avatar": "string",
              "id": 0,
              "name": "string"
            },
            "layerId": "string",
            "name": "string",
            "pageInfo": {
              "backgroundColor": "string",
              "frameName": "string",
              "layerId": "string",
              "pageId": "string",
              "pageName": "string"
            },
            "type": "string",
            "ukey": "string",
            "updatedAt": "string",
            "width": 0.0
          }
        ],
        "createdAt": "string",
        "creator": {
          "avatar": "string",
          "id": 0,
          "name": "string"
        },
        "documentId": 0,
        "documentName": "string",
        "id": "string",
        "projectId": 0,
        "publishedScope": "string",
        "styles": [
          {
            "cover": "string",
            "createdAt": "string",
            "description": "string",
            "documentId": 0,
            "lastUpdator": {
              "avatar": "string",
              "id": 0,
              "name": "string"
            },
            "name": "string",
            "sortIndex": "string",
            "styleSubType": 0,
            "styleType": "string",
            "ukey": "string",
            "updatedAt": "string"
          }
        ],
        "teamId": 0,
        "updatedAt": "string"
      }
    ]
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ teamLibraryarray<object>
    └─ componentSetsarray<object>团队库组件集列表
      └─ coverstring组件集封面
      └─ createdAtstring组件集创建时间
      └─ descriptionstring组件集描述
      └─ documentIdinteger组件集所属文档 ID
      └─ lastUpdatorobject组件集最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ layerIdstring组件集所属图层 ID
      └─ namestring组件集名称
      └─ pageInfoobject组件集页面信息
        └─ backgroundColorstring背景颜色
        └─ frameNamestring容器名称
        └─ layerIdstring图层 ID
        └─ pageIdstring页面 ID
        └─ pageNamestring页面名称
      └─ ukeystring组件集 UKey (唯一)
      └─ updatedAtstring组件集更新时间
    └─ componentsarray<object>团队库组件列表
      └─ componentSetUkeystring组件所属组件集 UKey
      └─ coverstring组件封面
      └─ createdAtstring组件创建时间
      └─ descriptionstring组件描述
      └─ documentIdinteger组件所属文档 ID
      └─ heightnumber组件高度
      └─ lastUpdatorobject组件最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ layerIdstring组件所属图层 ID
      └─ namestring组件名称
      └─ pageInfoobject组件页面信息
        └─ backgroundColorstring背景颜色
        └─ frameNamestring容器名称
        └─ layerIdstring图层 ID
        └─ pageIdstring页面 ID
        └─ pageNamestring页面名称
      └─ typestring组件类型
      └─ ukeystring组件 UKey (唯一)
      └─ updatedAtstring组件更新时间
      └─ widthnumber组件宽度
    └─ createdAtstring团队库创建时间
    └─ creatorobject团队库创建人信息
      └─ avatarstring用户头像
      └─ idinteger用户 ID
      └─ namestring用户名
    └─ documentIdinteger团队库文件 ID
    └─ documentNamestring团队库文件名称
    └─ idstring团队库 ID
    └─ projectIdinteger团队库所属项目 ID
    └─ publishedScopestring团队库发布范围
    └─ stylesarray<object>团队库样式列表
      └─ coverstring样式封面
      └─ createdAtstring样式创建时间
      └─ descriptionstring样式描述
      └─ documentIdinteger样式所属文档 ID
      └─ lastUpdatorobject样式最后更新人信息
        └─ avatarstring用户头像
        └─ idinteger用户 ID
        └─ namestring用户名
      └─ namestring样式名称
      └─ sortIndexstring样式子类型
      └─ styleSubTypeinteger样式子类型
      └─ styleTypestring样式类型
      └─ ukeystring样式 UKey (唯一)
      └─ updatedAtstring样式更新时间
    └─ teamIdinteger团队库所属团队 ID
    └─ updatedAtstring团队库更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

字体库

获取企业字体库

请求方法: GET

请求路径: /openapi/v1/organization/font

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
pageNumQueryinteger页码
pageSizeQueryinteger每页记录数
keywordQuerystring搜索关键字,用于搜索字体样式、字体名称、字体家族名称

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "family": "string",
      "localizedFamily": "string",
      "styles": [
        {
          "coverUrl": "string",
          "id": 0,
          "localizedStyle": "string",
          "style": "string",
          "url": "string"
        }
      ],
      "teamId": 0,
      "teamName": "string",
      "type": "string",
      "version": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ familystring字体名称
    └─ localizedFamilystring本地化字体名称
    └─ stylesarray<object>字体样式列表
      └─ coverUrlstring封面URL
      └─ idinteger字体ID
      └─ localizedStylestring本地化字体样式
      └─ stylestring字体样式
      └─ urlstring文件URL
    └─ teamIdinteger团队ID
    └─ teamNamestring团队名称
    └─ typestring字体类型,team团队字体 organization企业字体
    └─ versionstring版本号
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

删除企业字体库字体

请求方法: DELETE

请求路径: /openapi/v1/organization/font

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
fontIdsQueryarray字体ID列表
operatorIdQueryinteger操作人ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 删除用户所在团队字体库字体

请求方法: DELETE

请求路径: /openapi/v1/users/:userId/font-libraries/fonts

接口描述: 删除用户所在团队字体库字体

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID

请求体

参数名: ids - 字体ID列表

类型: 数组<integer>

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {},
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

私有化 获取用户所在团队字体库

请求方法: GET

请求路径: /openapi/v1/users/:userId/font-libraries/team/:teamId

接口描述: 获取用户所在团队字体库

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
userIdPathstring用户ID
teamIdPathstring团队ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "coverUrl": "string",
      "createAt": "string",
      "family": "string",
      "id": 0,
      "isVariable": true,
      "italic": 0,
      "localizedFamily": "string",
      "localizedStyle": "string",
      "monoSpace": 0,
      "organizationId": 0,
      "originUrl": "string",
      "postScriptName": "string",
      "style": "string",
      "teamId": 0,
      "type": "string",
      "updateAt": "string",
      "url": "string",
      "version": "string",
      "weight": 0,
      "width": 0
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverUrlstring封面url
    └─ createAtstring创建时间
    └─ familystring字体名
    └─ idintegerID
    └─ isVariableboolean是否为可变字体
    └─ italicinteger是否为斜体
    └─ localizedFamilystring本地化名字
    └─ localizedStylestring本地化样式
    └─ monoSpaceinteger是否为等宽字体
    └─ organizationIdinteger企业ID
    └─ originUrlstring存储TTC文件的URL
    └─ postScriptNamestringpostScriptName
    └─ stylestring样式
    └─ teamIdinteger团队ID
    └─ typestring字体类型 team团队字体 organization企业字体
    └─ updateAtstring更新时间
    └─ urlstring文件url
    └─ versionstring版本号
    └─ weightinteger字重
    └─ widthinteger字宽
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

文件分组

获取项目下所有分组

请求方法: GET

请求路径: /openapi/v1/project/:projectId/group

接口描述: 获取指定项目下的所有分组

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
projectIdPathstring项目ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "category": "string",
      "createAt": "string",
      "id": 0,
      "name": "string",
      "projectId": 0,
      "updateAt": "string"
    }
  ],
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ categorystring分组类型
    └─ createAtstring创建时间
    └─ idintegerID
    └─ namestring分组名称
    └─ projectIdinteger项目ID
    └─ updateAtstring更新时间
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

筛选分组下文件列表

请求方法: GET

请求路径: /openapi/v1/project/:projectId/group/:groupId/documents

接口描述: 分页获取指定分组下的文件,支持搜索、排序、分页

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

参数

参数名标签位置类型必填默认值描述
keywordQuerystring搜索关键词
sortQuerystring-updated_at排序字段
支持 name, created_at, updated_at
page[number]Queryinteger当前页数,从1开始
page[size]Queryinteger每页大小
projectIdPathstring项目ID
groupIdPathstring分组ID

响应

状态码 200: code - OK

{
  "code": "string",
  "data": [
    {
      "cover": "string",
      "coverBgColor": "string",
      "createdAt": "string",
      "creatorId": 0,
      "fileMode": 0,
      "id": 0,
      "name": "string",
      "ownerId": 0,
      "type": 0,
      "updatedAt": "string"
    }
  ],
  "meta": {
    "page": {
      "total": 0
    },
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataarray<object>
    └─ coverstring文件封面
    └─ coverBgColorstring文件封面背景颜色
    └─ createdAtstring创建时间
    └─ creatorIdinteger创建者ID
    └─ fileModeinteger文件模式; 0 设计文件,1 原型文件
    └─ idinteger文件ID
    └─ namestring文件名称
    └─ ownerIdinteger所有者ID
    └─ typeinteger文件类型
    └─ updatedAtstring更新时间
metaobject
  └─ pageobject分页信息
    └─ totalinteger总条数
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring

AI

私有化 查询 AI 积分明细

请求方法: POST

请求路径: /openapi/v1/ai/account/credit-records

接口描述: 查询 AI 积分明细,目前仅对私有化部署开放

请求头

参数名标签类型必填默认值描述
X-MG-AuthenticationstringOPENAPI 认证头

请求体

参数名: CreditRecordRequest - 积分记录查询请求参数

字段名类型必填描述
end_timestring结束时间,格式如"2024-01-31 23:59:59"
pageinteger页码,从1开始
page_sizeinteger每页数量
source_idsarray<string>第三方(客户系统)用户ID列表(可选)
start_timestring开始时间,格式如"2024-01-01 00:00:00"

响应

状态码 200: code - OK

{
  "code": "string",
  "data": {
    "records": [
      {
        "credit": 0,
        "id": 0,
        "model_type": 0,
        "operation": "string",
        "source_id": "string",
        "time": "string"
      }
    ],
    "total": 0
  },
  "meta": {
    "time": 0,
    "trace": "string"
  },
  "msg": "string"
}
字段名类型必填描述
codestring响应码, 成功为 OK, 其他的为错误码
dataobject
  └─ recordsarray<object>当前页的记录
    └─ creditinteger积分变动
    └─ idinteger记录ID
    └─ model_typeinteger模型 0 大匠 1 小匠
    └─ operationstring操作类型
    └─ source_idstring实体ID
    └─ timestring操作时间
  └─ totalinteger总记录数
metaobject
  └─ timeinteger
  └─ tracestring链路ID;
如果存在异常,可以提供该 ID 给 MasterGo 相关人员进行问题排查
msgstring