Feature/api (#10)

* Refactor server shutdown and signal handling

* Refactor server shutdown and signal handling

* Add server

* Refactor health check endpoint to include server and telegram status

* Refactor health check endpoint to include server and telegram status

* Refactor main.go to include server shutdown and signal handling

* Refactor main.go to include setting the maxprocs environment variable in container runtimes

* Refactor main.go to remove unused code for server shutdown and signal handling

* Refactor main.go to remove unused code for server shutdown and signal handling

* Refactor response.go to include error status and extra data

* File server

* Refactor main.go to remove unused code for echo endpoint

* Refactor main.go to remove duplicate code for echo endpoint

* Refactor response.go to include error status and extra data

* Refactor routes.go and server.go to improve echo endpoint functionality

* Refactor global package and add err package

* Add verification from API

* Refactor .golangci.yml to disable nestif linter

.golangci.yml

@@ -49,7 +49,7 @@ linters:
     - gosec # Inspects source code for security problems
     - misspell # Finds commonly misspelled English words in comments
     - nakedret # Finds naked returns in functions greater than a specified function length
-    - nestif # Reports deeply nested if statements
+    #- nestif # Reports deeply nested if statements
     - nilerr # Finds the code that returns nil even if it checks that the error is not nil.
     - noctx # noctx finds sending http request without context.Context
     - nolintlint # Reports ill-formed or insufficient nolint directives

api/response.go

@@ -0,0 +1,179 @@
+package api
+
+import (
+	"encoding/json"
+	"net/http"
+)
+
+const (
+	okStatus  = "ok"
+	errStatus = "error"
+)
+
+// Error is a generic error structure that is used to send error responses to the client.
+type Error struct {
+	Code    string      `json:"code"`
+	Message string      `json:"message"`
+	Extra   interface{} `json:"extra,omitempty"`
+}
+
+// Response is a generic response structure that is used to send responses to the client.
+type Response struct {
+	Status string      `json:"status"`
+	Data   interface{} `json:"data,omitempty"`
+	Error  *Error      `json:"error,omitempty"`
+}
+
+// NewResponse creates a new response object.
+func NewResponse() *Response {
+	return &Response{
+		Status: okStatus,
+	}
+}
+
+// Error message
+func (e *Error) Error() string {
+	return e.Message
+}
+
+// Set data to response
+func (rsp *Response) SetData(data interface{}) *Response {
+	rsp.Status = okStatus
+	rsp.Error = nil
+	rsp.Data = data
+
+	return rsp
+}
+
+// Set error to response
+func (rsp *Response) SetError(code string, message string, extra ...interface{}) *Response {
+	rsp.Status = errStatus
+	rsp.Data = nil
+
+	var extraData interface{}
+	if len(extra) > 0 {
+		extraData = extra[0] // Берем первый переданный аргумент, если он есть
+	} else {
+		extraData = nil // Если аргумент не был передан, оставляем nil
+	}
+
+	rsp.Error = &Error{
+		Code:    code,
+		Message: message,
+		Extra:   extraData,
+	}
+
+	return rsp
+}
+
+// Send success response to client
+func (rsp *Response) Ok(w http.ResponseWriter) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(http.StatusOK)
+
+	rsp.Status = "ok"
+
+	_ = json.NewEncoder(w).Encode(rsp)
+}
+
+// Send error response to client
+func (rsp *Response) BadRequest(w http.ResponseWriter) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(http.StatusBadRequest)
+
+	rsp.Status = errStatus
+
+	if rsp.Error == nil {
+		rsp.Error = &Error{
+			Code:    "bad_request",
+			Message: "Bad request",
+		}
+	}
+
+	_ = json.NewEncoder(w).Encode(rsp)
+}
+
+// Send error response to client
+func (rsp *Response) InternalServerError(w http.ResponseWriter) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(http.StatusInternalServerError)
+
+	rsp.Status = errStatus
+
+	if rsp.Error == nil {
+		rsp.Error = &Error{
+			Code:    "internal_server_error",
+			Message: "Internal server error",
+		}
+	}
+
+	_ = json.NewEncoder(w).Encode(rsp)
+}
+
+// Send error response to client
+func (rsp *Response) NotFound(w http.ResponseWriter) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(http.StatusNotFound)
+
+	rsp.Status = errStatus
+
+	if rsp.Error == nil {
+		rsp.Error = &Error{
+			Code:    "not_found",
+			Message: "Not found",
+		}
+	}
+
+	_ = json.NewEncoder(w).Encode(rsp)
+}
+
+// Send error response to client
+func (rsp *Response) Unauthorized(w http.ResponseWriter) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(http.StatusUnauthorized)
+
+	rsp.Status = errStatus
+
+	if rsp.Error == nil {
+		rsp.Error = &Error{
+			Code:    "unauthorized",
+			Message: "Unauthorized",
+		}
+	}
+
+	_ = json.NewEncoder(w).Encode(rsp)
+}
+
+// Send error response to client
+func (rsp *Response) Forbidden(w http.ResponseWriter) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(http.StatusForbidden)
+
+	rsp.Status = errStatus
+
+	if rsp.Error == nil {
+		rsp.Error = &Error{
+			Code:    "forbidden",
+			Message: "Forbidden",
+		}
+	}
+
+	_ = json.NewEncoder(w).Encode(rsp)
+}
+
+// Send error response to client
+func (rsp *Response) MethodNotAllowed(w http.ResponseWriter) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(http.StatusMethodNotAllowed)
+
+	rsp.Status = errStatus
+
+	if rsp.Error == nil {
+		rsp.Error = &Error{
+			Code:    "method_not_allowed",
+			Message: "Method not allowed",
+		}
+	}
+
+	_ = json.NewEncoder(w).Encode(rsp)
+}