{
  "openapi": "3.1.0",
  "info": {
    "title": "SQ hubb: API de ingesta",
    "version": "1.0.0",
    "description": "La API de ingesta permite a un vendedor acreditado enviar sus anuncios y sus stocks desde su ERP. Pasa por la misma cadena que la importación de archivos: mismos controles, mismos valores por defecto.\n\n- 60 llamadas por minuto y por token; más allá, respuesta 429 con la cabecera Retry-After.\n\n- Como máximo 500 artículos por llamada.\n\n- La referencia del vendedor es obligatoria. Una referencia ya conocida actualiza su anuncio: repetir una llamada nunca crea duplicados.\n\n- Un anuncio creado por la API nace como borrador y pasa por la moderación del marketplace antes de su publicación. Solo se modifican los campos enviados.\n\n- Añada dry_run=1 a una llamada de escritura: el lote se controla como lo sería, y la respuesta devuelve el mismo informe (creaciones, actualizaciones, rechazos detallados), pero no se escribe nada, ni anuncio, ni stock, ni paso en el registro. Cualquier token lo permite: es el token de prueba de su primera integración."
  },
  "servers": [
    {
      "url": "https://sqhubb.com/api/v1/ingestion"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/listings": {
      "post": {
        "operationId": "pushListings",
        "summary": "Crea o actualiza anuncios, por lotes.",
        "parameters": [
          {
            "name": "dry_run",
            "in": "query",
            "required": false,
            "description": "Añada dry_run=1 a una llamada de escritura: el lote se controla como lo sería, y la respuesta devuelve el mismo informe (creaciones, actualizaciones, rechazos detallados), pero no se escribe nada, ni anuncio, ni stock, ni paso en el registro. Cualquier token lo permite: es el token de prueba de su primera integración.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "janus",
            "in": "query",
            "required": false,
            "description": "Cuando el marketplace ha abierto Janus en importación, añada janus=1: los artículos se convierten en una importación Janus recibida (vinculación a la taxonomía, enriquecimiento), que usted lanza desde Mi Espacio tras ver su coste.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Respuesta",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            }
          },
          "202": {
            "description": "la importación Janus está recibida, para lanzar desde Mi Espacio.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            }
          },
          "400": {
            "description": "el cuerpo no es un JSON legible.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "invalid_json"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "token ausente, no válido o revocado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "unauthorized"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "la API no está abierta en este marketplace.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "suspended",
                            "closed"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "cuerpo no válido (sin lista, lista vacía, demasiados artículos, janus y dry_run juntos).",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "invalid_payload"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "demasiadas llamadas, vuelva a intentarlo tras el plazo indicado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limited"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "El número de segundos que hay que esperar antes de la próxima llamada.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "503": {
            "description": "control de caudal no disponible por el momento, reintente tras el plazo indicado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limiter_unavailable"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListingsBatch"
              },
              "example": {
                "listings": [
                  {
                    "reference": "SKU-001",
                    "title": "Réducteur SEW R97",
                    "price": 1850,
                    "currency": "EUR",
                    "quantity": 3,
                    "condition": "new_unused",
                    "incoterm": "EXW",
                    "brand": "SEW",
                    "model": "R97",
                    "origin_country": "DE",
                    "pickup_country": "FR",
                    "unit_weight_kg": 120,
                    "certifications": [
                      "CE"
                    ],
                    "price_tiers": [
                      {
                        "min_quantity": 2,
                        "unit_price": 1750
                      }
                    ],
                    "images": [
                      "https://images.example.com/sku-001-face.jpg"
                    ],
                    "specifications": {
                      "puissance": "7,5 kW",
                      "hs_code": "8483.40"
                    }
                  },
                  {
                    "reference": "SKU-002",
                    "price": 940,
                    "quantity": 0
                  }
                ]
              }
            }
          }
        }
      }
    },
    "/listings/{reference}": {
      "get": {
        "operationId": "getListing",
        "summary": "Lee un anuncio por su referencia: estado, precio, stock, traducciones.",
        "parameters": [
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "description": "Su referencia, obligatoria y única en su catálogo.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Respuesta",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListingResponse"
                }
              }
            }
          },
          "401": {
            "description": "token ausente, no válido o revocado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "unauthorized"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "la API no está abierta en este marketplace.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "suspended",
                            "closed"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "ningún anuncio de este vendedor lleva esta referencia.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "not_found"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "demasiadas llamadas, vuelva a intentarlo tras el plazo indicado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limited"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "El número de segundos que hay que esperar antes de la próxima llamada.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "503": {
            "description": "control de caudal no disponible por el momento, reintente tras el plazo indicado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limiter_unavailable"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/stocks": {
      "post": {
        "operationId": "pushStocks",
        "summary": "Actualiza la cantidad disponible, y el precio si se indica, por referencia. Una referencia desconocida se rechaza, nunca se crea.",
        "parameters": [
          {
            "name": "dry_run",
            "in": "query",
            "required": false,
            "description": "Añada dry_run=1 a una llamada de escritura: el lote se controla como lo sería, y la respuesta devuelve el mismo informe (creaciones, actualizaciones, rechazos detallados), pero no se escribe nada, ni anuncio, ni stock, ni paso en el registro. Cualquier token lo permite: es el token de prueba de su primera integración.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Respuesta",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            }
          },
          "400": {
            "description": "el cuerpo no es un JSON legible.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "invalid_json"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "token ausente, no válido o revocado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "unauthorized"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "la API no está abierta en este marketplace.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "suspended",
                            "closed"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "cuerpo no válido (sin lista, lista vacía, demasiados artículos, janus y dry_run juntos).",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "invalid_payload"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "demasiadas llamadas, vuelva a intentarlo tras el plazo indicado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limited"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "El número de segundos que hay que esperar antes de la próxima llamada.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "503": {
            "description": "control de caudal no disponible por el momento, reintente tras el plazo indicado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limiter_unavailable"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StocksBatch"
              },
              "example": {
                "stocks": [
                  {
                    "reference": "SKU-001",
                    "quantity": 2
                  },
                  {
                    "reference": "SKU-002",
                    "quantity": 5,
                    "price": 900
                  }
                ]
              }
            }
          }
        }
      }
    },
    "/runs": {
      "get": {
        "operationId": "listRuns",
        "summary": "Las veinte últimas ejecuciones, por la API y por la sincronización diaria.",
        "responses": {
          "200": {
            "description": "Respuesta",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunsResponse"
                }
              }
            }
          },
          "401": {
            "description": "token ausente, no válido o revocado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "unauthorized"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "la API no está abierta en este marketplace.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "suspended",
                            "closed"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "demasiadas llamadas, vuelva a intentarlo tras el plazo indicado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limited"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "El número de segundos que hay que esperar antes de la próxima llamada.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "503": {
            "description": "control de caudal no disponible por el momento, reintente tras el plazo indicado.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limiter_unavailable"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "sqh_…",
        "description": "Cada llamada lleva el token del vendedor en la cabecera Authorization. El token clasifica todo lo que envía bajo la empresa vendedora que lo creó."
      }
    },
    "schemas": {
      "Listing": {
        "type": "object",
        "required": [
          "reference"
        ],
        "properties": {
          "reference": {
            "type": "string",
            "description": "Su referencia, obligatoria y única en su catálogo."
          },
          "title": {
            "type": "string",
            "description": "El título del anuncio, obligatorio en la creación."
          },
          "description": {
            "type": "string",
            "description": "La descripción, en francés."
          },
          "summary": {
            "type": "string",
            "description": "Un resumen de una línea."
          },
          "category": {
            "type": "string",
            "description": "La familia: su nombre o su identificador (slug)."
          },
          "condition": {
            "type": "string",
            "description": "El estado del bien (valores abajo).",
            "examples": [
              "new_unused",
              "new_surplus",
              "workshop_checked",
              "audited",
              "good_condition",
              "dismantled_tagged",
              "for_parts"
            ]
          },
          "price": {
            "type": "number",
            "description": "El precio unitario sin impuestos."
          },
          "reference_price": {
            "type": "number",
            "description": "El precio de referencia (nuevo o de mercado), superior al precio."
          },
          "currency": {
            "type": "string",
            "description": "La divisa, EUR por defecto."
          },
          "quantity": {
            "type": "integer",
            "description": "La cantidad disponible."
          },
          "sale_unit": {
            "type": "string",
            "description": "La unidad de venta (unit, lot, tonne, kilogram, pallet...).",
            "examples": [
              "unit",
              "lot",
              "tonne",
              "kilogram",
              "liter",
              "square_meter",
              "linear_meter",
              "cubic_meter",
              "pallet"
            ]
          },
          "lot_size": {
            "type": "integer",
            "description": "El tamaño del lote."
          },
          "minimum_order_quantity": {
            "type": "integer",
            "description": "La cantidad mínima de pedido."
          },
          "packaging": {
            "type": "string",
            "description": "El embalaje (pallet, wooden_crate, big_bag...).",
            "examples": [
              "pallet",
              "wooden_crate",
              "big_bag",
              "bulk",
              "container",
              "parcel",
              "loose",
              "oversized"
            ]
          },
          "incoterm": {
            "type": "string",
            "description": "El Incoterm 2020 (valores abajo).",
            "examples": [
              "EXW",
              "FCA",
              "FAS",
              "FOB",
              "CFR",
              "CIF",
              "CPT",
              "CIP",
              "DAP",
              "DPU",
              "DDP"
            ]
          },
          "pickup_country": {
            "type": "string",
            "maxLength": 2,
            "description": "El país de recogida, código ISO de dos letras."
          },
          "pickup_region": {
            "type": "string",
            "description": "La región de recogida."
          },
          "pickup_city": {
            "type": "string",
            "description": "La ciudad de recogida."
          },
          "pickup_postal_code": {
            "type": "string",
            "description": "El código postal de recogida."
          },
          "origin_country": {
            "type": "string",
            "maxLength": 2,
            "description": "El país de origen, código ISO de dos letras."
          },
          "brand": {
            "type": "string",
            "description": "La marca."
          },
          "model": {
            "type": "string",
            "description": "El modelo o la referencia del fabricante."
          },
          "year_of_manufacture": {
            "type": "integer",
            "description": "El año de fabricación."
          },
          "unit_weight_kg": {
            "type": "number",
            "description": "El peso unitario en kilogramos."
          },
          "length_cm": {
            "type": "integer",
            "description": "La longitud en centímetros."
          },
          "width_cm": {
            "type": "integer",
            "description": "La anchura en centímetros."
          },
          "height_cm": {
            "type": "integer",
            "description": "La altura en centímetros."
          },
          "seo_title": {
            "type": "string",
            "description": "El título para los motores de búsqueda."
          },
          "seo_description": {
            "type": "string",
            "description": "La descripción para los motores de búsqueda."
          },
          "certifications": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "La lista de certificaciones y sellos, por ejemplo [\"CE\", \"ISO 9001\"]."
          },
          "price_tiers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PriceTier"
            },
            "description": "Los tramos de precio por volumen sin IVA, por ejemplo [{\"min_quantity\": 10, \"unit_price\": 95}]. Un tramo igual o superior al precio base se descarta."
          },
          "images": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "format": "uri",
              "maxLength": 2000
            },
            "description": "Las direcciones web de las fotos (JPEG, PNG o WebP, 10 MB como máximo), cinco como máximo. La primera se convierte en la foto principal. Se descargan después de guardar el anuncio."
          },
          "specifications": {
            "type": "object",
            "description": "Las características de la familia, como objeto clave y valor.",
            "additionalProperties": {
              "type": [
                "string",
                "number",
                "boolean"
              ]
            }
          }
        }
      },
      "ListingsBatch": {
        "type": "object",
        "required": [
          "listings"
        ],
        "properties": {
          "listings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Listing"
            },
            "maxItems": 500,
            "minItems": 1
          }
        }
      },
      "StockLine": {
        "type": "object",
        "required": [
          "reference",
          "quantity"
        ],
        "properties": {
          "reference": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "minimum": 0
          },
          "price": {
            "type": "number"
          }
        }
      },
      "StocksBatch": {
        "type": "object",
        "required": [
          "stocks"
        ],
        "properties": {
          "stocks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StockLine"
            },
            "maxItems": 500
          }
        }
      },
      "PriceTier": {
        "type": "object",
        "required": [
          "min_quantity",
          "unit_price"
        ],
        "properties": {
          "min_quantity": {
            "type": "integer",
            "minimum": 1
          },
          "unit_price": {
            "type": "number"
          }
        }
      },
      "Run": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "channel": {
            "type": "string",
            "enum": [
              "api",
              "sync"
            ]
          },
          "kind": {
            "type": "string",
            "enum": [
              "listings",
              "stocks"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "partial",
              "failed",
              "unchanged",
              "janus_received"
            ]
          },
          "received": {
            "type": "integer"
          },
          "created": {
            "type": [
              "integer",
              "null"
            ]
          },
          "updated": {
            "type": [
              "integer",
              "null"
            ]
          },
          "rejected": {
            "type": [
              "integer",
              "null"
            ]
          },
          "rejections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reference": {
                  "type": "string"
                },
                "reasons": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "error": {
            "type": [
              "string",
              "null"
            ]
          },
          "janus_import_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "started_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "finished_at": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "RunResponse": {
        "type": "object",
        "required": [
          "run"
        ],
        "properties": {
          "run": {
            "$ref": "#/components/schemas/Run"
          },
          "dry_run": {
            "type": "boolean",
            "description": "Añada dry_run=1 a una llamada de escritura: el lote se controla como lo sería, y la respuesta devuelve el mismo informe (creaciones, actualizaciones, rechazos detallados), pero no se escribe nada, ni anuncio, ni stock, ni paso en el registro. Cualquier token lo permite: es el token de prueba de su primera integración."
          }
        }
      },
      "RunsResponse": {
        "type": "object",
        "properties": {
          "runs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Run"
            }
          }
        }
      },
      "ListingResponse": {
        "type": "object",
        "properties": {
          "listing": {
            "type": "object",
            "properties": {
              "reference": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "price": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "price_on_request": {
                "type": "boolean"
              },
              "currency": {
                "type": "string"
              },
              "quantity": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "condition": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "incoterm": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "category": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "origin_country": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "certifications": {
                "type": "array"
              },
              "price_tiers": {
                "type": "array"
              },
              "updated_at": {
                "type": "string"
              },
              "translations": {
                "type": "array"
              }
            }
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "error",
          "message"
        ],
        "properties": {
          "error": {
            "type": "string",
            "enum": [
              "invalid_json",
              "unauthorized",
              "suspended",
              "closed",
              "not_found",
              "invalid_payload",
              "rate_limited",
              "rate_limiter_unavailable"
            ]
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}