补充文档

2024-11-21 21:57:50 +08:00 · 2024-11-21 21:57:50 +08:00 · ca9d697a6a
commit ca9d697a6a
parent 3c34997623
3 changed files with 44 additions and 12 deletions
--- a/docs/docs.go
+++ b/docs/docs.go
@ -677,9 +677,15 @@ const docTemplate = `{
                "id": {
                    "type": "integer"
                },
-                "img": {
+                "imgString": {
                    "type": "string"
                },
+                "imgs": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
                "itemname": {
                    "type": "string"
                },
@ -738,9 +744,15 @@ const docTemplate = `{
                    "example": "这是一个女大自用的iPhone18"
                },
                "img": {
-                    "description": "@description 图片ID，请用 /file/upload/item-img 接口上传图片后获取的图片唯一标识",
-                    "type": "string",
-                    "example": "123456789012"
+                    "description": "@description 图片ID，请用 /file/upload/item-img 接口上传图片后获取的图片唯一标识，多张图片请数组上传",
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "example": [
+                        "123456789012",
+                        "abcdefghijkl"
+                    ]
                },
                "itemname": {
                    "type": "string",
--- a/docs/swagger.json
+++ b/docs/swagger.json
@ -671,9 +671,15 @@
                "id": {
                    "type": "integer"
                },
-                "img": {
+                "imgString": {
                    "type": "string"
                },
+                "imgs": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
                "itemname": {
                    "type": "string"
                },
@ -732,9 +738,15 @@
                    "example": "这是一个女大自用的iPhone18"
                },
                "img": {
-                    "description": "@description 图片ID，请用 /file/upload/item-img 接口上传图片后获取的图片唯一标识",
-                    "type": "string",
-                    "example": "123456789012"
+                    "description": "@description 图片ID，请用 /file/upload/item-img 接口上传图片后获取的图片唯一标识，多张图片请数组上传",
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "example": [
+                        "123456789012",
+                        "abcdefghijkl"
+                    ]
                },
                "itemname": {
                    "type": "string",
--- a/docs/swagger.yaml
+++ b/docs/swagger.yaml
@ -8,8 +8,12 @@ definitions:
        type: string
      id:
        type: integer
-      img:
+      imgString:
        type: string
+      imgs:
+        items:
+          type: string
+        type: array
      itemname:
        type: string
      price:
@ -44,9 +48,13 @@ definitions:
        example: 这是一个女大自用的iPhone18
        type: string
      img:
-        description: '@description 图片ID，请用 /file/upload/item-img 接口上传图片后获取的图片唯一标识'
-        example: "123456789012"
+        description: '@description 图片ID，请用 /file/upload/item-img 接口上传图片后获取的图片唯一标识，多张图片请数组上传'
+        example:
+        - "123456789012"
+        - abcdefghijkl
+        items:
          type: string
+        type: array
      itemname:
        example: 女大自用iPhone18
        maxLength: 12