# Generated with protoc-gen-openapi
# https://github.com/google/gnostic/tree/master/cmd/protoc-gen-openapi

openapi: 3.0.3
info:
    title: RealWorld API
    description: The greeting service definition.
    version: 0.0.1
paths:
    /api/articles:
        get:
            tags:
                - RealWorld
            operationId: RealWorld_ListArticles
            parameters:
                - name: tag
                  in: query
                  schema:
                    type: string
                - name: author
                  in: query
                  schema:
                    type: string
                - name: favorited
                  in: query
                  schema:
                    type: string
                - name: limit
                  in: query
                  schema:
                    type: string
                - name: offset
                  in: query
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.MultipleArticlesReply'
        post:
            tags:
                - RealWorld
            operationId: RealWorld_CreateArticle
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/realworld.v1.CreateArticleRequest'
                required: true
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.SingleArticleReply'
    /api/articles/feed:
        get:
            tags:
                - RealWorld
            operationId: RealWorld_FeedArticles
            parameters:
                - name: limit
                  in: query
                  schema:
                    type: string
                - name: offset
                  in: query
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.MultipleArticlesReply'
    /api/articles/{slug}:
        get:
            tags:
                - RealWorld
            operationId: RealWorld_GetArticle
            parameters:
                - name: slug
                  in: path
                  required: true
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.SingleArticleReply'
        put:
            tags:
                - RealWorld
            operationId: RealWorld_UpdateArticle
            parameters:
                - name: slug
                  in: path
                  required: true
                  schema:
                    type: string
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/realworld.v1.UpdateArticleRequest'
                required: true
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.SingleArticleReply'
        delete:
            tags:
                - RealWorld
            operationId: RealWorld_DeleteArticle
            parameters:
                - name: slug
                  in: path
                  required: true
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.SingleArticleReply'
    /api/articles/{slug}/comments:
        get:
            tags:
                - RealWorld
            operationId: RealWorld_GetComments
            parameters:
                - name: slug
                  in: path
                  required: true
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.MultipleCommentsReply'
        post:
            tags:
                - RealWorld
            operationId: RealWorld_AddComment
            parameters:
                - name: slug
                  in: path
                  required: true
                  schema:
                    type: string
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/realworld.v1.AddCommentRequest'
                required: true
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.SingleCommentReply'
    /api/articles/{slug}/comments/{id}:
        delete:
            tags:
                - RealWorld
            operationId: RealWorld_DeleteComment
            parameters:
                - name: slug
                  in: path
                  required: true
                  schema:
                    type: string
                - name: id
                  in: path
                  required: true
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.SingleCommentReply'
    /api/articles/{slug}/favorite:
        get:
            tags:
                - RealWorld
            operationId: RealWorld_FavoriteArticle
            parameters:
                - name: slug
                  in: path
                  required: true
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.SingleArticleReply'
        delete:
            tags:
                - RealWorld
            operationId: RealWorld_UnfavoriteArticle
            parameters:
                - name: slug
                  in: path
                  required: true
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.SingleArticleReply'
    /api/profiles/{username}:
        get:
            tags:
                - RealWorld
            operationId: RealWorld_GetProfile
            parameters:
                - name: username
                  in: path
                  required: true
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.ProfileReply'
    /api/profiles/{username}/follow:
        put:
            tags:
                - RealWorld
            operationId: RealWorld_FollowUser
            parameters:
                - name: username
                  in: path
                  required: true
                  schema:
                    type: string
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/realworld.v1.FollowUserRequest'
                required: true
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.ProfileReply'
        delete:
            tags:
                - RealWorld
            operationId: RealWorld_UnFollowUser
            parameters:
                - name: username
                  in: path
                  required: true
                  schema:
                    type: string
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.ProfileReply'
    /api/tags:
        get:
            tags:
                - RealWorld
            operationId: RealWorld_GetTags
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.GetTagsReply'
    /api/user:
        get:
            tags:
                - RealWorld
            operationId: RealWorld_GetCurrentUser
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.UserReply'
        put:
            tags:
                - RealWorld
            operationId: RealWorld_UpdateUser
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/realworld.v1.UpdateUserRequest'
                required: true
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.UserReply'
    /api/users:
        post:
            tags:
                - RealWorld
            operationId: RealWorld_Register
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/realworld.v1.RegisterRequest'
                required: true
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.UserReply'
    /api/users/login:
        post:
            tags:
                - RealWorld
            operationId: RealWorld_Login
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/realworld.v1.LoginRequest'
                required: true
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/realworld.v1.UserReply'
components:
    schemas:
        realworld.v1.AddCommentRequest:
            type: object
            properties:
                comment:
                    $ref: '#/components/schemas/realworld.v1.AddCommentRequest_Comment'
                slug:
                    type: string
        realworld.v1.AddCommentRequest_Comment:
            type: object
            properties:
                body:
                    type: string
        realworld.v1.CreateArticleRequest:
            type: object
            properties:
                article:
                    $ref: '#/components/schemas/realworld.v1.CreateArticleRequest_Article'
        realworld.v1.CreateArticleRequest_Article:
            type: object
            properties:
                title:
                    type: string
                description:
                    type: string
                body:
                    type: string
                tagList:
                    type: array
                    items:
                        type: string
        realworld.v1.FollowUserRequest:
            type: object
            properties:
                username:
                    type: string
        realworld.v1.GetTagsReply:
            type: object
            properties:
                tags:
                    type: array
                    items:
                        type: string
        realworld.v1.LoginRequest:
            type: object
            properties:
                user:
                    $ref: '#/components/schemas/realworld.v1.LoginRequest_User'
        realworld.v1.LoginRequest_User:
            type: object
            properties:
                email:
                    type: string
                password:
                    type: string
        realworld.v1.MultipleArticlesReply:
            type: object
            properties:
                articles:
                    type: array
                    items:
                        $ref: '#/components/schemas/realworld.v1.MultipleArticlesReply_Articles'
                articlesCount:
                    type: integer
                    format: uint32
        realworld.v1.MultipleArticlesReply_Articles:
            type: object
            properties:
                slug:
                    type: string
                title:
                    type: string
                description:
                    type: string
                body:
                    type: string
                tagList:
                    type: array
                    items:
                        type: string
                createdAt:
                    type: string
                updatedAt:
                    type: string
                favorited:
                    type: boolean
                favoritesCount:
                    type: integer
                    format: uint32
                author:
                    $ref: '#/components/schemas/realworld.v1.MultipleArticlesReply_Author'
        realworld.v1.MultipleArticlesReply_Author:
            type: object
            properties:
                username:
                    type: string
                bio:
                    type: string
                image:
                    type: string
                following:
                    type: boolean
        realworld.v1.MultipleCommentsReply:
            type: object
            properties:
                comments:
                    type: array
                    items:
                        $ref: '#/components/schemas/realworld.v1.MultipleCommentsReply_Comments'
        realworld.v1.MultipleCommentsReply_Author:
            type: object
            properties:
                username:
                    type: string
                bio:
                    type: string
                image:
                    type: string
                following:
                    type: boolean
        realworld.v1.MultipleCommentsReply_Comments:
            type: object
            properties:
                id:
                    type: integer
                    format: uint32
                createdAt:
                    type: string
                updatedAt:
                    type: string
                body:
                    type: string
                author:
                    $ref: '#/components/schemas/realworld.v1.MultipleCommentsReply_Author'
        realworld.v1.ProfileReply:
            type: object
            properties:
                profile:
                    $ref: '#/components/schemas/realworld.v1.ProfileReply_Profile'
        realworld.v1.ProfileReply_Profile:
            type: object
            properties:
                username:
                    type: string
                bio:
                    type: string
                image:
                    type: string
                following:
                    type: boolean
        realworld.v1.RegisterRequest:
            type: object
            properties:
                user:
                    $ref: '#/components/schemas/realworld.v1.RegisterRequest_User'
        realworld.v1.RegisterRequest_User:
            type: object
            properties:
                username:
                    type: string
                email:
                    type: string
                password:
                    type: string
        realworld.v1.SingleArticleReply:
            type: object
            properties:
                article:
                    $ref: '#/components/schemas/realworld.v1.SingleArticleReply_Article'
        realworld.v1.SingleArticleReply_Article:
            type: object
            properties:
                slug:
                    type: string
                title:
                    type: string
                description:
                    type: string
                body:
                    type: string
                tagList:
                    type: array
                    items:
                        type: string
                createdAt:
                    type: string
                updatedAt:
                    type: string
                favorited:
                    type: boolean
                favoritesCount:
                    type: integer
                    format: uint32
                author:
                    $ref: '#/components/schemas/realworld.v1.SingleArticleReply_Author'
        realworld.v1.SingleArticleReply_Author:
            type: object
            properties:
                username:
                    type: string
                bio:
                    type: string
                image:
                    type: string
                following:
                    type: boolean
        realworld.v1.SingleCommentReply:
            type: object
            properties:
                comment:
                    $ref: '#/components/schemas/realworld.v1.SingleCommentReply_Comment'
        realworld.v1.SingleCommentReply_Author:
            type: object
            properties:
                username:
                    type: string
                bio:
                    type: string
                image:
                    type: string
                following:
                    type: boolean
        realworld.v1.SingleCommentReply_Comment:
            type: object
            properties:
                id:
                    type: integer
                    format: uint32
                createdAt:
                    type: string
                updatedAt:
                    type: string
                body:
                    type: string
                author:
                    $ref: '#/components/schemas/realworld.v1.SingleCommentReply_Author'
        realworld.v1.UpdateArticleRequest:
            type: object
            properties:
                article:
                    $ref: '#/components/schemas/realworld.v1.UpdateArticleRequest_Article'
                slug:
                    type: string
        realworld.v1.UpdateArticleRequest_Article:
            type: object
            properties:
                title:
                    type: string
                description:
                    type: string
                body:
                    type: string
                tagList:
                    type: array
                    items:
                        type: string
        realworld.v1.UpdateUserRequest:
            type: object
            properties:
                user:
                    $ref: '#/components/schemas/realworld.v1.UpdateUserRequest_User'
        realworld.v1.UpdateUserRequest_User:
            type: object
            properties:
                email:
                    type: string
                token:
                    type: string
                username:
                    type: string
                bio:
                    type: string
                image:
                    type: string
        realworld.v1.UserReply:
            type: object
            properties:
                user:
                    $ref: '#/components/schemas/realworld.v1.UserReply_User'
        realworld.v1.UserReply_User:
            type: object
            properties:
                email:
                    type: string
                token:
                    type: string
                username:
                    type: string
                bio:
                    type: string
                image:
                    type: string
tags:
    - name: RealWorld