u

docs/api/openapi.json

@@ -1012,6 +1012,100 @@
         }
       }
     },
+    "/article/{sku}/image": {
+      "post": {
+        "tags": [
+          "Article"
+        ],
+        "summary": "Add article image",
+        "description": "Accepts a full-size AVIF body (`Content-Type: image/avif`).\nFull: stored as-is when already AVIF and ≤1000×1000; otherwise scaled to max 1000×1000.\nThumb always scaled to max 200×200. Stores hash/thumbhash, links `articlepic`.\nAuth like GET by SKU.\n",
+        "security": [
+          {
+            "cookieAuth": []
+          }
+        ],
+        "x-markdown": "article/add-image.md",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "sku",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Article SKU"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "image/avif": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Image stored and linked",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "image": {
+                      "$ref": "#/components/schemas/ArticleImage"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Missing body or invalid image",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Not authorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Article not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/auth/selected-company": {
       "put": {
         "tags": [
@@ -1378,6 +1472,68 @@
         "type": "object",
         "description": "Full article payload (unit, brand, categoryIds, photos, eans, prices, …)",
         "additionalProperties": true
+      },
+      "ArticleImage": {
+        "type": "object",
+        "required": [
+          "picId",
+          "sort",
+          "full",
+          "thumb",
+          "hash",
+          "thumbHash"
+        ],
+        "properties": {
+          "picId": {
+            "type": "integer"
+          },
+          "sort": {
+            "type": "integer"
+          },
+          "full": {
+            "type": "object",
+            "required": [
+              "w",
+              "h",
+              "size"
+            ],
+            "properties": {
+              "w": {
+                "type": "integer"
+              },
+              "h": {
+                "type": "integer"
+              },
+              "size": {
+                "type": "integer",
+                "description": "Byte length of full AVIF (as-is when already AVIF ≤1000×1000)"
+              }
+            }
+          },
+          "thumb": {
+            "type": "object",
+            "required": [
+              "w",
+              "h"
+            ],
+            "properties": {
+              "w": {
+                "type": "integer"
+              },
+              "h": {
+                "type": "integer"
+              }
+            }
+          },
+          "hash": {
+            "type": "string",
+            "description": "SHA-256 hex of full image bytes"
+          },
+          "thumbHash": {
+            "type": "string",
+            "description": "Base64 thumbhash of thumb preview"
+          }
+        }
       }
     }
   }