openapi: 3.1.0
info:
  title: "WaltherShop Product API"
  description: "دریافت لیست محصولات فروشگاه والتر برای نمایش در هوش مصنوعی (مانند ChatGPT)."
  version: "1.0.0"

servers:
  - url: https://walthershop.ir

paths:
  /walther-openapi/v1/products:
    get:
      summary: "لیست محصولات فروشگاه"
      operationId: getProducts
      description: "دریافت فهرست عمومی محصولات شامل نام، قیمت، تصویر، لینک، وضعیت موجودی و توضیح کوتاه"
      parameters:
        - name: page
          in: query
          description: "شماره صفحه نتایج"
          required: false
          schema:
            type: integer
            default: 1
        - name: per_page
          in: query
          description: "تعداد محصولات در هر صفحه (پیش‌فرض: 30)"
          required: false
          schema:
            type: integer
            default: 30
        - name: search
          in: query
          description: "جستجوی محصولات براساس نام"
          required: false
          schema:
            type: string
        - name: category
          in: query
          description: "فیلتر براساس اسلاگ دسته‌بندی"
          required: false
          schema:
            type: string
      responses:
        '200':
          description: "پاسخ موفق شامل لیست محصولات"
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: integer
                    example: 1
                  per_page:
                    type: integer
                    example: 30
                  total_found:
                    type: integer
                    example: 146
                  products:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 123
                        name:
                          type: string
                          example: "گرامافون والتر مدل 106"
                        description:
                          type: string
                          example: "مدل فول‌چوب با طراحی کلاسیک و صدای گرم"
                        price:
                          type: string
                          example: "14900000"
                        image:
                          type: string
                          format: uri
                          example: "https://walthershop.ir/wp-content/uploads/2024/10/gramophone.webp"
                        url:
                          type: string
                          format: uri
                          example: "https://walthershop.ir/product/gramophone-106"
                        availability:
                          type: string
                          enum: [in_stock, out_of_stock]
                          example: "in_stock"
