openapi: 3.0.3
info:
  title: Twitter OpenAPI
  version: 0.0.1

paths:
  /graphql/{pathQueryId}/UserByScreenName:
    get:
      operationId: getUserByScreenName
      description: "get user by screen name"
      responses:
        "200":
          description: Successful operation
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: "#/components/schemas/UserResponse"
                  - $ref: "./../schemas/error.yaml#/components/schemas/Errors"
      tags:
        - "user"

  /graphql/{pathQueryId}/UserByRestId:
    get:
      operationId: getUserByRestId
      description: "get user by rest id"
      responses:
        "200":
          description: Successful operation
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: "#/components/schemas/UserResponse"
                  - $ref: "./../schemas/error.yaml#/components/schemas/Errors"
      tags:
        - "user"

  /graphql/{pathQueryId}/UsersByRestIds:
    get:
      operationId: getUsersByRestIds
      description: "get users by rest ids"
      responses:
        "200":
          description: Successful operation
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: "#/components/schemas/UsersResponse"
                  - $ref: "./../schemas/error.yaml#/components/schemas/Errors"
      tags:
        - "users"

components:
  schemas:
    UserResponse:
      required:
        - "data"
      properties:
        data:
          $ref: "#/components/schemas/UserResponseData"

    UserResponseData:
      required:
        - "user"
      properties:
        user:
          $ref: "./../schemas/user.yaml#/components/schemas/UserResults"

    UsersResponse:
      required:
        - "data"
      properties:
        data:
          $ref: "#/components/schemas/UsersResponseData"

    UsersResponseData:
      required:
        - "users"
      properties:
        users:
          type: array
          items:
            $ref: "./../schemas/user.yaml#/components/schemas/UserResults"