@leaflow/sdk 0.1.3 → 0.2.0

package/openapi/iam.yaml

@@ -1,6 +1,18 @@
 components:
   schemas:
-    AcceptInvitationByTokenInputBody:
+    AcceptConsentsRequestBody:
+      additionalProperties: false
+      properties:
+        consents:
+          items:
+            $ref: "#/components/schemas/ConsentBody"
+          type:
+            - array
+            - "null"
+      required:
+        - consents
+      type: object
+    AcceptInvitationByTokenRequestBody:
       additionalProperties: false
       properties:
         token:
@@ -10,15 +22,15 @@ components:
       required:
         - token
       type: object
-    AcceptInvitationOutputBody:
+    AcceptedInvitationResponseBody:
       additionalProperties: false
       properties:
         project:
-          $ref: "#/components/schemas/ProjectView"
+          $ref: "#/components/schemas/ProjectResource"
       required:
         - project
       type: object
-    AccountView:
+    AccountResource:
       additionalProperties: false
       properties:
         created_at:
@@ -40,6 +52,12 @@ components:
         last_name:
           description: 来自登录信息，可能为空
           type: string
+        pending_agreements:
+          items:
+            $ref: "#/components/schemas/AgreementResource"
+          type:
+            - array
+            - "null"
         status:
           enum:
             - ACTIVE
@@ -47,11 +65,6 @@ components:
             - BANNED
             - DELETING
           type: string
-        terms_accepted_at:
-          format: date-time
-          type:
-            - string
-            - "null"
       required:
         - id
         - email
@@ -59,10 +72,101 @@ components:
         - last_name
         - status
         - email_verified_at
-        - terms_accepted_at
         - created_at
+        - pending_agreements
       type: object
-    CreateProjectInputBody:
+    AgreementListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/AgreementResource"
+          type:
+            - array
+            - "null"
+      required:
+        - items
+      type: object
+    AgreementResource:
+      additionalProperties: false
+      properties:
+        effective_at:
+          description: 从这一刻起注册必须同意这一版
+          format: date-time
+          type: string
+        type:
+          enum:
+            - TERMS
+            - PRIVACY
+            - DPA
+          type: string
+        url:
+          description: 正文发布在哪
+          type: string
+        version:
+          description: 同意时原样回传这个值
+          type: string
+      required:
+        - type
+        - version
+        - url
+        - effective_at
+      type: object
+    ConsentBody:
+      additionalProperties: false
+      properties:
+        type:
+          enum:
+            - TERMS
+            - PRIVACY
+            - DPA
+          type: string
+        version:
+          maxLength: 32
+          type: string
+      required:
+        - type
+        - version
+      type: object
+    ConsentListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/ConsentResource"
+          type:
+            - array
+            - "null"
+      required:
+        - items
+      type: object
+    ConsentResource:
+      additionalProperties: false
+      properties:
+        consented_at:
+          format: date-time
+          type: string
+        method:
+          description: OFFLINE 是线下签的，由运营录入
+          enum:
+            - CLICKWRAP
+            - OFFLINE
+          type: string
+        type:
+          enum:
+            - TERMS
+            - PRIVACY
+            - DPA
+          type: string
+        version:
+          type: string
+      required:
+        - type
+        - version
+        - consented_at
+        - method
+      type: object
+    CreateProjectRequestBody:
       additionalProperties: false
       properties:
         description:
@@ -75,7 +179,7 @@ components:
       required:
         - name
       type: object
-    CreateProjectSSHKeyInputBody:
+    CreateProjectSSHKeyRequestBody:
       additionalProperties: false
       properties:
         name:
@@ -88,7 +192,7 @@ components:
         - name
         - public_key
       type: object
-    CreateRoleInputBody:
+    CreateRoleRequestBody:
       additionalProperties: false
       properties:
         code:
@@ -112,7 +216,7 @@ components:
         - code
         - name
       type: object
-    CreateUserSSHKeyInputBody:
+    CreateUserSSHKeyRequestBody:
       additionalProperties: false
       properties:
         name:
@@ -143,38 +247,7 @@ components:
         - status
         - message
       type: object
-    ExchangeTokenOutputBody:
-      additionalProperties: false
-      properties:
-        expires_at:
-          description: 过期时刻。到点之前拿用户身份再换一张，别等第一个 401
-          format: date-time
-          type: string
-        expires_in:
-          description: 还能活多少秒
-          format: int64
-          type: integer
-        grant:
-          $ref: "#/components/schemas/GrantView"
-          description: "**这一份是此刻的快照，不在令牌里，也不要缓存它。** 它只用来决定界面上画什么；真正的判定每次都要重新问"
-        project:
-          $ref: "#/components/schemas/ProjectView"
-          description: 顺带带上项目本身，省掉换完之后立刻再查一次
-        token:
-          description: "项目令牌，放进 Authorization: Bearer 里用"
-          type: string
-        token_type:
-          description: 固定是 Bearer
-          type: string
-      required:
-        - token
-        - token_type
-        - expires_at
-        - expires_in
-        - project
-        - grant
-      type: object
-    GrantView:
+    GrantResource:
       additionalProperties: false
       properties:
         admin:
@@ -201,7 +274,7 @@ components:
         - permissions
         - roles
       type: object
-    IdentityVerificationView:
+    IdentityVerificationResource:
       additionalProperties: false
       properties:
         reject_reason:
@@ -231,7 +304,23 @@ components:
         - verified_at
         - reject_reason
       type: object
-    InvitationView:
+    InvitationListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/InvitationResource"
+          type:
+            - array
+            - "null"
+        total:
+          format: int64
+          type: integer
+      required:
+        - items
+        - total
+      type: object
+    InvitationResource:
       additionalProperties: false
       properties:
         created_at:
@@ -266,7 +355,7 @@ components:
         - expires_at
         - created_at
       type: object
-    IssueInvitationInputBody:
+    IssueInvitationRequestBody:
       additionalProperties: false
       properties:
         email:
@@ -285,11 +374,11 @@ components:
         - email
         - roles
       type: object
-    IssueInvitationOutputBody:
+    IssuedInvitationResponseBody:
       additionalProperties: false
       properties:
         invitation:
-          $ref: "#/components/schemas/InvitationView"
+          $ref: "#/components/schemas/InvitationResource"
         token:
           description: 兑现用的明文，**只在这一次响应里出现**。库里只有它的哈希，丢了只能撤销重发
           type: string
@@ -297,12 +386,12 @@ components:
         - invitation
         - token
       type: object
-    ListInvitationsOutputBody:
+    MemberListResponseBody:
       additionalProperties: false
       properties:
         items:
           items:
-            $ref: "#/components/schemas/InvitationView"
+            $ref: "#/components/schemas/MemberResource"
           type:
             - array
             - "null"
@@ -313,79 +402,7 @@ components:
         - items
         - total
       type: object
-    ListMembersOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/MemberView"
-          type:
-            - array
-            - "null"
-        total:
-          format: int64
-          type: integer
-      required:
-        - items
-        - total
-      type: object
-    ListPermissionsOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/PermissionView"
-          type:
-            - array
-            - "null"
-      required:
-        - items
-      type: object
-    ListProjectsOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/ProjectListItem"
-          type:
-            - array
-            - "null"
-        total:
-          format: int64
-          type: integer
-      required:
-        - items
-        - total
-      type: object
-    ListRolesOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/RoleView"
-          type:
-            - array
-            - "null"
-      required:
-        - items
-      type: object
-    ListSSHKeysOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/SSHKeyView"
-          type:
-            - array
-            - "null"
-        total:
-          format: int64
-          type: integer
-      required:
-        - items
-        - total
-      type: object
-    MemberView:
+    MemberResource:
       additionalProperties: false
       properties:
         created_at:
@@ -398,7 +415,7 @@ components:
         first_name:
           type: string
         grant:
-          $ref: "#/components/schemas/GrantView"
+          $ref: "#/components/schemas/GrantResource"
         last_name:
           type: string
         user_id:
@@ -412,11 +429,11 @@ components:
         - created_by
         - created_at
       type: object
-    MembershipView:
+    MembershipResource:
       additionalProperties: false
       properties:
         grant:
-          $ref: "#/components/schemas/GrantView"
+          $ref: "#/components/schemas/GrantResource"
         member:
           type: boolean
         project_status:
@@ -429,7 +446,31 @@ components:
         - user_status
         - project_status
       type: object
-    PermissionView:
+    OwnershipTransferResponseBody:
+      additionalProperties: false
+      properties:
+        from:
+          $ref: "#/components/schemas/MemberResource"
+          description: 原所有者。他保留其余的角色——转让的是所有权，不是把人踢出去
+        to:
+          $ref: "#/components/schemas/MemberResource"
+      required:
+        - from
+        - to
+      type: object
+    PermissionListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/PermissionResource"
+          type:
+            - array
+            - "null"
+      required:
+        - items
+      type: object
+    PermissionResource:
       additionalProperties: false
       properties:
         description:
@@ -444,18 +485,34 @@ components:
         - description
         - owner_only
       type: object
-    ProjectListItem:
+    ProjectAccessListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/ProjectAccessResource"
+          type:
+            - array
+            - "null"
+        total:
+          format: int64
+          type: integer
+      required:
+        - items
+        - total
+      type: object
+    ProjectAccessResource:
       additionalProperties: false
       properties:
         grant:
-          $ref: "#/components/schemas/GrantView"
+          $ref: "#/components/schemas/GrantResource"
         project:
-          $ref: "#/components/schemas/ProjectView"
+          $ref: "#/components/schemas/ProjectResource"
       required:
         - project
         - grant
       type: object
-    ProjectView:
+    ProjectResource:
       additionalProperties: false
       properties:
         ban_reason:
@@ -511,7 +568,51 @@ components:
         - created_at
         - updated_at
       type: object
-    RenameProjectSSHKeyInputBody:
+    ProjectTokenResponseBody:
+      additionalProperties: false
+      properties:
+        expires_at:
+          description: 过期时刻。到点之前拿用户身份再换一张，别等第一个 401
+          format: date-time
+          type: string
+        expires_in:
+          description: 还能活多少秒
+          format: int64
+          type: integer
+        grant:
+          $ref: "#/components/schemas/GrantResource"
+          description: "**这一份是此刻的快照，不在令牌里，也不要缓存它。** 它只用来决定界面上画什么；真正的判定每次都要重新问"
+        project:
+          $ref: "#/components/schemas/ProjectResource"
+          description: 顺带带上项目本身，省掉换完之后立刻再查一次
+        token:
+          description: "项目令牌，放进 Authorization: Bearer 里用"
+          type: string
+        token_type:
+          description: 固定是 Bearer
+          type: string
+      required:
+        - token
+        - token_type
+        - expires_at
+        - expires_in
+        - project
+        - grant
+      type: object
+    RegisterRequestBody:
+      additionalProperties: false
+      properties:
+        consents:
+          description: 当前生效的必签文件全部要在里面，版本号要和 GET /api/v1/agreements 给的一致
+          items:
+            $ref: "#/components/schemas/ConsentBody"
+          type:
+            - array
+            - "null"
+      required:
+        - consents
+      type: object
+    RenameProjectSSHKeyRequestBody:
       additionalProperties: false
       properties:
         name:
@@ -520,7 +621,7 @@ components:
       required:
         - name
       type: object
-    RenameUserSSHKeyInputBody:
+    RenameUserSSHKeyRequestBody:
       additionalProperties: false
       properties:
         name:
@@ -529,7 +630,19 @@ components:
       required:
         - name
       type: object
-    RoleView:
+    RoleListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/RoleResource"
+          type:
+            - array
+            - "null"
+      required:
+        - items
+      type: object
+    RoleResource:
       additionalProperties: false
       properties:
         builtin:
@@ -562,7 +675,23 @@ components:
         - created_at
         - updated_at
       type: object
-    SSHKeyView:
+    SSHKeyListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/SSHKeyResource"
+          type:
+            - array
+            - "null"
+        total:
+          format: int64
+          type: integer
+      required:
+        - items
+        - total
+      type: object
+    SSHKeyResource:
       additionalProperties: false
       properties:
         created_at:
@@ -593,7 +722,7 @@ components:
         - status
         - created_at
       type: object
-    SetMemberRolesInputBody:
+    SetMemberRolesRequestBody:
       additionalProperties: false
       properties:
         roles:
@@ -606,7 +735,7 @@ components:
       required:
         - roles
       type: object
-    SubmitIdentityVerificationInputBody:
+    SubmitIdentityVerificationRequestBody:
       additionalProperties: false
       properties:
         id_number:
@@ -622,7 +751,7 @@ components:
         - real_name
         - id_number
       type: object
-    TransferOwnershipInputBody:
+    TransferOwnershipRequestBody:
       additionalProperties: false
       properties:
         to_user_id:
@@ -632,19 +761,7 @@ components:
       required:
         - to_user_id
       type: object
-    TransferOwnershipOutputBody:
-      additionalProperties: false
-      properties:
-        from:
-          $ref: "#/components/schemas/MemberView"
-          description: 原所有者。他保留其余的角色——转让的是所有权，不是把人踢出去
-        to:
-          $ref: "#/components/schemas/MemberView"
-      required:
-        - from
-        - to
-      type: object
-    UpdateProjectInputBody:
+    UpdateProjectRequestBody:
       additionalProperties: false
       properties:
         description:
@@ -654,7 +771,7 @@ components:
           maxLength: 128
           type: string
       type: object
-    UpdateRoleInputBody:
+    UpdateRoleRequestBody:
       additionalProperties: false
       properties:
         description:
@@ -693,8 +810,32 @@ info:
   version: 1.0.0
 openapi: 3.1.0
 paths:
+  /api/v1/agreements:
+    get:
+      description: |-
+        注册页显示它，用户同意之后把每一项的 `type` 和 `version` 原样回传给 `POST /api/v1/register`。
+
+        不需要令牌。还没有任何文件生效时返回空数组，那时注册不需要提交 `consents`。
+      operationId: list-agreements
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AgreementListResponseBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 列出注册必须同意的文件
+      tags:
+        - Agreement
   /api/v1/me:
     get:
+      description: "`pending_agreements` 是还没同意的文件，非空就要先引导用户同意，再调 `POST /api/v1/me/consents`。"
       operationId: get-account
       parameters:
         - description: Bearer 令牌。选定项目之前用 auth.leaflow.net 签发的账号令牌，选定之后用项目令牌
@@ -709,7 +850,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AccountView"
+                $ref: "#/components/schemas/AccountResource"
           description: OK
         default:
           content:
@@ -720,6 +861,70 @@ paths:
       summary: 查看当前账号
       tags:
         - Account
+  /api/v1/me/consents:
+    get:
+      description: 全部记录，最新的在前，包括已经不是当前版本的那些。
+      operationId: list-consents
+      parameters:
+        - description: Bearer 令牌。选定项目之前用 auth.leaflow.net 签发的账号令牌，选定之后用项目令牌
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer 令牌。选定项目之前用 auth.leaflow.net 签发的账号令牌，选定之后用项目令牌
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ConsentListResponseBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 列出我同意过的文件
+      tags:
+        - Agreement
+    post:
+      description: |-
+        条款改版之后用它重新同意，`GET /api/v1/me` 的 `pending_agreements` 非空时就该调。
+
+        只收当前生效的版本，签旧版答 409。重复提交同一版不报错，第一次那条记录会留着。
+      operationId: accept-agreements
+      parameters:
+        - description: Bearer 令牌。选定项目之前用 auth.leaflow.net 签发的账号令牌，选定之后用项目令牌
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer 令牌。选定项目之前用 auth.leaflow.net 签发的账号令牌，选定之后用项目令牌
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AcceptConsentsRequestBody"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AccountResource"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 同意条款
+      tags:
+        - Agreement
   /api/v1/me/identity-verification:
     get:
       description: 没交过材料时答 UNVERIFIED，不是 404。姓名和证件号不会出现在任何响应里。
@@ -737,7 +942,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IdentityVerificationView"
+                $ref: "#/components/schemas/IdentityVerificationResource"
           description: OK
         default:
           content:
@@ -763,14 +968,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/SubmitIdentityVerificationInputBody"
+              $ref: "#/components/schemas/SubmitIdentityVerificationRequestBody"
         required: true
       responses:
         "202":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IdentityVerificationView"
+                $ref: "#/components/schemas/IdentityVerificationResource"
           description: Accepted
         default:
           content:
@@ -818,7 +1023,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListInvitationsOutputBody"
+                $ref: "#/components/schemas/InvitationListResponseBody"
           description: OK
         default:
           content:
@@ -845,14 +1050,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AcceptInvitationByTokenInputBody"
+              $ref: "#/components/schemas/AcceptInvitationByTokenRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AcceptInvitationOutputBody"
+                $ref: "#/components/schemas/AcceptedInvitationResponseBody"
           description: OK
         default:
           content:
@@ -886,7 +1091,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AcceptInvitationOutputBody"
+                $ref: "#/components/schemas/AcceptedInvitationResponseBody"
           description: OK
         default:
           content:
@@ -943,7 +1148,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListSSHKeysOutputBody"
+                $ref: "#/components/schemas/SSHKeyListResponseBody"
           description: OK
         default:
           content:
@@ -968,14 +1173,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateUserSSHKeyInputBody"
+              $ref: "#/components/schemas/CreateUserSSHKeyRequestBody"
         required: true
       responses:
         "201":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SSHKeyView"
+                $ref: "#/components/schemas/SSHKeyResource"
           description: Created
         default:
           content:
@@ -1009,7 +1214,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SSHKeyView"
+                $ref: "#/components/schemas/SSHKeyResource"
           description: OK
         default:
           content:
@@ -1041,7 +1246,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SSHKeyView"
+                $ref: "#/components/schemas/SSHKeyResource"
           description: OK
         default:
           content:
@@ -1073,14 +1278,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/RenameUserSSHKeyInputBody"
+              $ref: "#/components/schemas/RenameUserSSHKeyRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SSHKeyView"
+                $ref: "#/components/schemas/SSHKeyResource"
           description: OK
         default:
           content:
@@ -1091,34 +1296,6 @@ paths:
       summary: 给我的公钥改名
       tags:
         - SSHKey
-  /api/v1/me/terms:
-    post:
-      description: 幂等：已经同意过的不会被推到今天——那一列是法务要的证据，说的是他哪一次同意的。
-      operationId: accept-terms
-      parameters:
-        - description: Bearer 令牌。选定项目之前用 auth.leaflow.net 签发的账号令牌，选定之后用项目令牌
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: Bearer 令牌。选定项目之前用 auth.leaflow.net 签发的账号令牌，选定之后用项目令牌
-            type: string
-      responses:
-        "200":
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/AccountView"
-          description: OK
-        default:
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/Error"
-          description: Error
-      summary: 同意服务条款
-      tags:
-        - Account
   /api/v1/permissions:
     get:
       description: "**只有 IAM 这一份。** 别的服务的操作不在这里——权限目录是各服务各自声明、由 各个服务自己声明的，IAM 认识它们就等于要跟着每个下游一起发版。"
@@ -1128,7 +1305,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListPermissionsOutputBody"
+                $ref: "#/components/schemas/PermissionListResponseBody"
           description: OK
         default:
           content:
@@ -1197,7 +1374,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListProjectsOutputBody"
+                $ref: "#/components/schemas/ProjectAccessListResponseBody"
           description: OK
         default:
           content:
@@ -1223,14 +1400,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateProjectInputBody"
+              $ref: "#/components/schemas/CreateProjectRequestBody"
         required: true
       responses:
         "201":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ProjectListItem"
+                $ref: "#/components/schemas/ProjectAccessResource"
           description: Created
         default:
           content:
@@ -1264,7 +1441,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ProjectListItem"
+                $ref: "#/components/schemas/ProjectAccessResource"
           description: OK
         default:
           content:
@@ -1297,7 +1474,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ProjectListItem"
+                $ref: "#/components/schemas/ProjectAccessResource"
           description: OK
         default:
           content:
@@ -1328,14 +1505,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/UpdateProjectInputBody"
+              $ref: "#/components/schemas/UpdateProjectRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ProjectListItem"
+                $ref: "#/components/schemas/ProjectAccessResource"
           description: OK
         default:
           content:
@@ -1389,7 +1566,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListInvitationsOutputBody"
+                $ref: "#/components/schemas/InvitationListResponseBody"
           description: OK
         default:
           content:
@@ -1421,14 +1598,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/IssueInvitationInputBody"
+              $ref: "#/components/schemas/IssueInvitationRequestBody"
         required: true
       responses:
         "201":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IssueInvitationOutputBody"
+                $ref: "#/components/schemas/IssuedInvitationResponseBody"
           description: Created
         default:
           content:
@@ -1524,7 +1701,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListMembersOutputBody"
+                $ref: "#/components/schemas/MemberListResponseBody"
           description: OK
         default:
           content:
@@ -1599,14 +1776,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/SetMemberRolesInputBody"
+              $ref: "#/components/schemas/SetMemberRolesRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/MemberView"
+                $ref: "#/components/schemas/MemberResource"
           description: OK
         default:
           content:
@@ -1640,7 +1817,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/MembershipView"
+                $ref: "#/components/schemas/MembershipResource"
           description: OK
         default:
           content:
@@ -1673,7 +1850,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListRolesOutputBody"
+                $ref: "#/components/schemas/RoleListResponseBody"
           description: OK
         default:
           content:
@@ -1704,14 +1881,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateRoleInputBody"
+              $ref: "#/components/schemas/CreateRoleRequestBody"
         required: true
       responses:
         "201":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/RoleView"
+                $ref: "#/components/schemas/RoleResource"
           description: Created
         default:
           content:
@@ -1785,7 +1962,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/RoleView"
+                $ref: "#/components/schemas/RoleResource"
           description: OK
         default:
           content:
@@ -1823,14 +2000,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/UpdateRoleInputBody"
+              $ref: "#/components/schemas/UpdateRoleRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/RoleView"
+                $ref: "#/components/schemas/RoleResource"
           description: OK
         default:
           content:
@@ -1891,7 +2068,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListSSHKeysOutputBody"
+                $ref: "#/components/schemas/SSHKeyListResponseBody"
           description: OK
         default:
           content:
@@ -1922,14 +2099,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateProjectSSHKeyInputBody"
+              $ref: "#/components/schemas/CreateProjectSSHKeyRequestBody"
         required: true
       responses:
         "201":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SSHKeyView"
+                $ref: "#/components/schemas/SSHKeyResource"
           description: Created
         default:
           content:
@@ -1968,7 +2145,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SSHKeyView"
+                $ref: "#/components/schemas/SSHKeyResource"
           description: OK
         default:
           content:
@@ -2006,7 +2183,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SSHKeyView"
+                $ref: "#/components/schemas/SSHKeyResource"
           description: OK
         default:
           content:
@@ -2043,14 +2220,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/RenameProjectSSHKeyInputBody"
+              $ref: "#/components/schemas/RenameProjectSSHKeyRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SSHKeyView"
+                $ref: "#/components/schemas/SSHKeyResource"
           description: OK
         default:
           content:
@@ -2093,7 +2270,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ExchangeTokenOutputBody"
+                $ref: "#/components/schemas/ProjectTokenResponseBody"
           description: Created
         default:
           content:
@@ -2126,14 +2303,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/TransferOwnershipInputBody"
+              $ref: "#/components/schemas/TransferOwnershipRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TransferOwnershipOutputBody"
+                $ref: "#/components/schemas/OwnershipTransferResponseBody"
           description: OK
         default:
           content:
@@ -2144,4 +2321,41 @@ paths:
       summary: 转移项目所有权
       tags:
         - Member
+  /api/v1/register:
+    post:
+      description: |-
+        在 auth.leaflow.net 登录之后调它，带上账号令牌。姓名和邮箱取自登录信息，不从请求体收。
+
+        `consents` 要覆盖 `GET /api/v1/agreements` 返回的每一份，版本号也要一致；漏一份答 400，版本对不上答 409（多半是页面开着的时候条款改版了，重新拉一次清单即可）。已经注册过的答 409。
+      operationId: register
+      parameters:
+        - description: auth.leaflow.net 签发的账号令牌，形如 Bearer <token>
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: auth.leaflow.net 签发的账号令牌，形如 Bearer <token>
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/RegisterRequestBody"
+        required: true
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AccountResource"
+          description: Created
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 注册账号
+      tags:
+        - Account