Update template go

2025-08-14 09:08:34 +07:00
parent 8c6fb0ce48
commit a64cbf4438
23 changed files with 4297 additions and 137 deletions
--- a/docs/swagger.yaml
+++ b/docs/swagger.yaml
@@ -0,0 +1,316 @@
+basePath: /api/v1
+definitions:
+  models.ErrorResponse:
+    properties:
+      code:
+        type: integer
+      error:
+        type: string
+      message:
+        type: string
+    type: object
+  models.ExampleGetResponse:
+    properties:
+      message:
+        type: string
+    type: object
+  models.ExamplePostRequest:
+    properties:
+      age:
+        type: integer
+      name:
+        type: string
+    required:
+    - age
+    - name
+    type: object
+  models.ExamplePostResponse:
+    properties:
+      id:
+        type: string
+      message:
+        type: string
+    type: object
+  models.HealthResponse:
+    properties:
+      details:
+        additionalProperties:
+          type: string
+        type: object
+      status:
+        type: string
+      timestamp:
+        type: string
+    type: object
+  models.HelloWorldResponse:
+    properties:
+      message:
+        type: string
+      version:
+        type: string
+    type: object
+  models.ProductCreateRequest:
+    properties:
+      name:
+        type: string
+    required:
+    - name
+    type: object
+  models.ProductCreateResponse:
+    properties:
+      data: {}
+      id:
+        type: string
+      message:
+        type: string
+    type: object
+  models.ProductDeleteResponse:
+    properties:
+      id:
+        type: string
+      message:
+        type: string
+    type: object
+  models.ProductGetByIDResponse:
+    properties:
+      id:
+        type: string
+      message:
+        type: string
+    type: object
+  models.ProductGetResponse:
+    properties:
+      data: {}
+      message:
+        type: string
+    type: object
+  models.ProductUpdateRequest:
+    properties:
+      name:
+        type: string
+    required:
+    - name
+    type: object
+  models.ProductUpdateResponse:
+    properties:
+      data: {}
+      id:
+        type: string
+      message:
+        type: string
+    type: object
+host: localhost:8080
+info:
+  contact:
+    email: support@swagger.io
+    name: API Support
+    url: http://www.swagger.io/support
+  description: A comprehensive Go API service with Swagger documentation
+  license:
+    name: Apache 2.0
+    url: http://www.apache.org/licenses/LICENSE-2.0.html
+  termsOfService: http://swagger.io/terms/
+  title: API Service
+  version: 1.0.0
+paths:
+  /:
+    get:
+      consumes:
+      - application/json
+      description: Returns a hello world message
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Hello world message
+          schema:
+            $ref: '#/definitions/models.HelloWorldResponse'
+      summary: Hello World endpoint
+      tags:
+      - root
+  /api/v1/example:
+    get:
+      consumes:
+      - application/json
+      description: Returns a simple message for GET request
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Example GET response
+          schema:
+            $ref: '#/definitions/models.ExampleGetResponse'
+      summary: Example GET service
+      tags:
+      - example
+    post:
+      consumes:
+      - application/json
+      description: Accepts a JSON payload and returns a response with an ID
+      parameters:
+      - description: Example POST request
+        in: body
+        name: request
+        required: true
+        schema:
+          $ref: '#/definitions/models.ExamplePostRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Example POST response
+          schema:
+            $ref: '#/definitions/models.ExamplePostResponse'
+        "400":
+          description: Bad request
+          schema:
+            $ref: '#/definitions/models.ErrorResponse'
+      summary: Example POST service
+      tags:
+      - example
+  /api/v1/products:
+    get:
+      consumes:
+      - application/json
+      description: Returns a list of products
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Product GET response
+          schema:
+            $ref: '#/definitions/models.ProductGetResponse'
+      summary: Get product
+      tags:
+      - product
+    post:
+      consumes:
+      - application/json
+      description: Creates a new product
+      parameters:
+      - description: Product creation request
+        in: body
+        name: request
+        required: true
+        schema:
+          $ref: '#/definitions/models.ProductCreateRequest'
+      produces:
+      - application/json
+      responses:
+        "201":
+          description: Product created successfully
+          schema:
+            $ref: '#/definitions/models.ProductCreateResponse'
+        "400":
+          description: Bad request
+          schema:
+            $ref: '#/definitions/models.ErrorResponse'
+      summary: Create product
+      tags:
+      - product
+  /api/v1/products/{id}:
+    delete:
+      consumes:
+      - application/json
+      description: Deletes a product by ID
+      parameters:
+      - description: Product ID
+        in: path
+        name: id
+        required: true
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Product deleted successfully
+          schema:
+            $ref: '#/definitions/models.ProductDeleteResponse'
+        "404":
+          description: Product not found
+          schema:
+            $ref: '#/definitions/models.ErrorResponse'
+      summary: Delete product
+      tags:
+      - product
+    get:
+      consumes:
+      - application/json
+      description: Returns a single product by ID
+      parameters:
+      - description: Product ID
+        in: path
+        name: id
+        required: true
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Product GET by ID response
+          schema:
+            $ref: '#/definitions/models.ProductGetByIDResponse'
+        "404":
+          description: Product not found
+          schema:
+            $ref: '#/definitions/models.ErrorResponse'
+      summary: Get product by ID
+      tags:
+      - product
+    put:
+      consumes:
+      - application/json
+      description: Updates an existing product
+      parameters:
+      - description: Product ID
+        in: path
+        name: id
+        required: true
+        type: string
+      - description: Product update request
+        in: body
+        name: request
+        required: true
+        schema:
+          $ref: '#/definitions/models.ProductUpdateRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Product updated successfully
+          schema:
+            $ref: '#/definitions/models.ProductUpdateResponse'
+        "400":
+          description: Bad request
+          schema:
+            $ref: '#/definitions/models.ErrorResponse'
+        "404":
+          description: Product not found
+          schema:
+            $ref: '#/definitions/models.ErrorResponse'
+      summary: Update product
+      tags:
+      - product
+  /health:
+    get:
+      consumes:
+      - application/json
+      description: Returns the health status of the API service
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Health status
+          schema:
+            $ref: '#/definitions/models.HealthResponse'
+        "500":
+          description: Internal server error
+          schema:
+            $ref: '#/definitions/models.ErrorResponse'
+      summary: Health check endpoint
+      tags:
+      - health
+schemes:
+- http
+- https
+swagger: "2.0"