feat: add transaction create endpoint for v2 (#708)

Author: morremeyer

Makefile

@@ -26,3 +26,8 @@ VERSION ?= $(shell git rev-parse HEAD)
 .PHONY: build
 build:
 	go build -ldflags "-X github.com/envelope-zero/backend/v2/pkg/router.version=${VERSION}"
+
+
+.PHONY: docs
+docs:
+	swag init --parseDependency --output ./api

api/docs.go

@@ -2807,6 +2807,105 @@
                 }
             }
         },
+        "/v2": {
+            "get": {
+                "description": "Returns general information about the v2 API",
+                "tags": [
+                    "v2"
+                ],
+                "summary": "v2 API",
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/router.V2Response"
+                        }
+                    }
+                }
+            },
+            "options": {
+                "description": "Returns an empty response with the HTTP Header \"allow\" set to the allowed HTTP verbs",
+                "tags": [
+                    "v2"
+                ],
+                "summary": "Allowed HTTP verbs",
+                "responses": {
+                    "204": {
+                        "description": "No Content"
+                    }
+                }
+            }
+        },
+        "/v2/transactions": {
+            "post": {
+                "description": "Creates transactions from the list of submitted transaction data. The response code is the highest response code number that a single transaction creation would have caused. If it is not equal to 201, at least one transaction has an error.",
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Transactions"
+                ],
+                "summary": "Create transactions",
+                "parameters": [
+                    {
+                        "description": "Transactions",
+                        "name": "transactions",
+                        "in": "body",
+                        "required": true,
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/models.TransactionCreate"
+                            }
+                        }
+                    }
+                ],
+                "responses": {
+                    "201": {
+                        "description": "Created",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/controllers.ResponseTransactionV2"
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/controllers.ResponseTransactionV2"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "Not Found"
+                    },
+                    "500": {
+                        "description": "Internal Server Error",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/controllers.ResponseTransactionV2"
+                            }
+                        }
+                    }
+                }
+            },
+            "options": {
+                "description": "Returns an empty response with the HTTP Header \"allow\" set to the allowed HTTP verbs",
+                "tags": [
+                    "Transactions"
+                ],
+                "summary": "Allowed HTTP verbs",
+                "responses": {
+                    "204": {
+                        "description": "No Content"
+                    }
+                }
+            }
+        },
         "/version": {
             "get": {
                 "description": "Returns the software version of the API",
@@ -3170,6 +3269,24 @@
                 }
             }
         },
+        "controllers.ResponseTransactionV2": {
+            "type": "object",
+            "properties": {
+                "data": {
+                    "description": "This field contains the transaction data",
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/models.Transaction"
+                        }
+                    ]
+                },
+                "error": {
+                    "description": "This field contains a human readable error message",
+                    "type": "string",
+                    "example": "A human readable error message"
+                }
+            }
+        },
         "controllers.TransactionListResponse": {
             "type": "object",
             "properties": {
@@ -4083,6 +4200,11 @@
                     "type": "string",
                     "example": "https://example.com/api/v1"
                 },
+                "v2": {
+                    "description": "List endpoint for all v2 endpoints",
+                    "type": "string",
+                    "example": "https://example.com/api/v2"
+                },
                 "version": {
                     "description": "Endpoint returning the version of the backend",
                     "type": "string",
@@ -4156,6 +4278,29 @@
                 }
             }
         },
+        "router.V2Links": {
+            "type": "object",
+            "properties": {
+                "transactions": {
+                    "description": "URL of transaction list endpoint",
+                    "type": "string",
+                    "example": "https://example.com/api/v2/transactions"
+                }
+            }
+        },
+        "router.V2Response": {
+            "type": "object",
+            "properties": {
+                "links": {
+                    "description": "Links for the v2 API",
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/router.V2Links"
+                        }
+                    ]
+                }
+            }
+        },
         "router.VersionObject": {
             "type": "object",
             "properties": {