{
  "openapi": "3.1.0",
  "info": {
    "title": "SQ hubb : API d'ingestion",
    "version": "1.0.0",
    "description": "L'API d'ingestion permet à un vendeur accrédité de pousser ses annonces et ses stocks depuis son ERP. Elle passe par la même chaîne que l'import de fichier : mêmes contrôles, mêmes valeurs par défaut.\n\n- 60 appels par minute et par jeton ; au-delà, réponse 429 avec l'en-tête Retry-After.\n\n- 500 articles au plus par appel.\n\n- La référence vendeur est obligatoire. Une référence déjà connue chez vous met à jour son annonce : rejouer un appel ne crée jamais de doublon.\n\n- Une annonce créée par l'API naît en brouillon et passe par la modération de la place avant publication. Seuls les champs envoyés sont modifiés.\n\n- Ajoutez dry_run=1 à un appel d'écriture : le lot est contrôlé comme il le serait, et la réponse rend le même rapport (créations, mises à jour, refus détaillés), mais rien n'est écrit, ni annonce, ni stock, ni passage au journal. Tout jeton le permet : c'est le jeton d'essai du premier branchement."
  },
  "servers": [
    {
      "url": "https://sqhubb.com/api/v1/ingestion"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/listings": {
      "post": {
        "operationId": "pushListings",
        "summary": "Crée ou met à jour des annonces, par lot.",
        "parameters": [
          {
            "name": "dry_run",
            "in": "query",
            "required": false,
            "description": "Ajoutez dry_run=1 à un appel d'écriture : le lot est contrôlé comme il le serait, et la réponse rend le même rapport (créations, mises à jour, refus détaillés), mais rien n'est écrit, ni annonce, ni stock, ni passage au journal. Tout jeton le permet : c'est le jeton d'essai du premier branchement.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "janus",
            "in": "query",
            "required": false,
            "description": "Quand la place a ouvert Janus sur import, ajoutez janus=1 : les articles deviennent un import Janus reçu (rattachement à la taxonomie, enrichissement), que vous lancez depuis Mon espace après avoir vu son coût.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Réponse",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            }
          },
          "202": {
            "description": "l'import Janus est reçu, à lancer depuis Mon espace.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            }
          },
          "400": {
            "description": "le corps n'est pas un JSON lisible.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "invalid_json"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "jeton absent, invalide ou révoqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "unauthorized"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "l'API n'est pas ouverte sur cette place.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "suspended",
                            "closed"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "corps invalide (pas de liste, liste vide, trop d'articles, janus et dry_run ensemble).",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "invalid_payload"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "trop d'appels, réessayez après le délai indiqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limited"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Le nombre de secondes à attendre avant le prochain appel.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "503": {
            "description": "contrôle du débit momentanément indisponible, réessayez après le délai indiqué.",
            "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": "Relit une annonce par sa référence : statut, prix, stock, traductions.",
        "parameters": [
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "description": "Votre référence, obligatoire et unique chez vous.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Réponse",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListingResponse"
                }
              }
            }
          },
          "401": {
            "description": "jeton absent, invalide ou révoqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "unauthorized"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "l'API n'est pas ouverte sur cette place.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "suspended",
                            "closed"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "aucune annonce de ce vendeur ne porte cette référence.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "not_found"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "trop d'appels, réessayez après le délai indiqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limited"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Le nombre de secondes à attendre avant le prochain appel.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "503": {
            "description": "contrôle du débit momentanément indisponible, réessayez après le délai indiqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limiter_unavailable"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/stocks": {
      "post": {
        "operationId": "pushStocks",
        "summary": "Met à jour la quantité disponible, et le prix s'il est fourni, par référence. Une référence inconnue est refusée, jamais créée.",
        "parameters": [
          {
            "name": "dry_run",
            "in": "query",
            "required": false,
            "description": "Ajoutez dry_run=1 à un appel d'écriture : le lot est contrôlé comme il le serait, et la réponse rend le même rapport (créations, mises à jour, refus détaillés), mais rien n'est écrit, ni annonce, ni stock, ni passage au journal. Tout jeton le permet : c'est le jeton d'essai du premier branchement.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Réponse",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            }
          },
          "400": {
            "description": "le corps n'est pas un JSON lisible.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "invalid_json"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "jeton absent, invalide ou révoqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "unauthorized"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "l'API n'est pas ouverte sur cette place.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "suspended",
                            "closed"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "corps invalide (pas de liste, liste vide, trop d'articles, janus et dry_run ensemble).",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "invalid_payload"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "trop d'appels, réessayez après le délai indiqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limited"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Le nombre de secondes à attendre avant le prochain appel.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "503": {
            "description": "contrôle du débit momentanément indisponible, réessayez après le délai indiqué.",
            "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": "Les vingt derniers passages, par l'API comme par la synchronisation quotidienne.",
        "responses": {
          "200": {
            "description": "Réponse",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunsResponse"
                }
              }
            }
          },
          "401": {
            "description": "jeton absent, invalide ou révoqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "unauthorized"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "l'API n'est pas ouverte sur cette place.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "suspended",
                            "closed"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "trop d'appels, réessayez après le délai indiqué.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "properties": {
                        "error": {
                          "enum": [
                            "rate_limited"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Le nombre de secondes à attendre avant le prochain appel.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "503": {
            "description": "contrôle du débit momentanément indisponible, réessayez après le délai indiqué.",
            "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": "Chaque appel porte le jeton du vendeur dans l'en-tête Authorization. Le jeton range tout ce qu'il pousse sous l'entreprise vendeuse qui l'a créé."
      }
    },
    "schemas": {
      "Listing": {
        "type": "object",
        "required": [
          "reference"
        ],
        "properties": {
          "reference": {
            "type": "string",
            "description": "Votre référence, obligatoire et unique chez vous."
          },
          "title": {
            "type": "string",
            "description": "Le titre de l'annonce, obligatoire à la création."
          },
          "description": {
            "type": "string",
            "description": "Le descriptif, en français."
          },
          "summary": {
            "type": "string",
            "description": "Un résumé d'une ligne."
          },
          "category": {
            "type": "string",
            "description": "La famille : son nom ou son identifiant (slug)."
          },
          "condition": {
            "type": "string",
            "description": "L'état du bien (valeurs ci-dessous).",
            "examples": [
              "new_unused",
              "new_surplus",
              "workshop_checked",
              "audited",
              "good_condition",
              "dismantled_tagged",
              "for_parts"
            ]
          },
          "price": {
            "type": "number",
            "description": "Le prix unitaire hors taxes."
          },
          "reference_price": {
            "type": "number",
            "description": "Le prix de référence (neuf ou marché), supérieur au prix."
          },
          "currency": {
            "type": "string",
            "description": "La devise, EUR par défaut."
          },
          "quantity": {
            "type": "integer",
            "description": "La quantité disponible."
          },
          "sale_unit": {
            "type": "string",
            "description": "L'unité de vente (unit, lot, tonne, kilogram, pallet...).",
            "examples": [
              "unit",
              "lot",
              "tonne",
              "kilogram",
              "liter",
              "square_meter",
              "linear_meter",
              "cubic_meter",
              "pallet"
            ]
          },
          "lot_size": {
            "type": "integer",
            "description": "La taille du lot."
          },
          "minimum_order_quantity": {
            "type": "integer",
            "description": "La quantité minimale de commande."
          },
          "packaging": {
            "type": "string",
            "description": "Le conditionnement (pallet, wooden_crate, big_bag...).",
            "examples": [
              "pallet",
              "wooden_crate",
              "big_bag",
              "bulk",
              "container",
              "parcel",
              "loose",
              "oversized"
            ]
          },
          "incoterm": {
            "type": "string",
            "description": "L'incoterm 2020 (valeurs ci-dessous).",
            "examples": [
              "EXW",
              "FCA",
              "FAS",
              "FOB",
              "CFR",
              "CIF",
              "CPT",
              "CIP",
              "DAP",
              "DPU",
              "DDP"
            ]
          },
          "pickup_country": {
            "type": "string",
            "maxLength": 2,
            "description": "Le pays d'enlèvement, code ISO à deux lettres."
          },
          "pickup_region": {
            "type": "string",
            "description": "La région d'enlèvement."
          },
          "pickup_city": {
            "type": "string",
            "description": "La ville d'enlèvement."
          },
          "pickup_postal_code": {
            "type": "string",
            "description": "Le code postal d'enlèvement."
          },
          "origin_country": {
            "type": "string",
            "maxLength": 2,
            "description": "Le pays d'origine, code ISO à deux lettres."
          },
          "brand": {
            "type": "string",
            "description": "La marque."
          },
          "model": {
            "type": "string",
            "description": "Le modèle ou la référence constructeur."
          },
          "year_of_manufacture": {
            "type": "integer",
            "description": "L'année de fabrication."
          },
          "unit_weight_kg": {
            "type": "number",
            "description": "Le poids unitaire en kilogrammes."
          },
          "length_cm": {
            "type": "integer",
            "description": "La longueur en centimètres."
          },
          "width_cm": {
            "type": "integer",
            "description": "La largeur en centimètres."
          },
          "height_cm": {
            "type": "integer",
            "description": "La hauteur en centimètres."
          },
          "seo_title": {
            "type": "string",
            "description": "Le titre pour les moteurs de recherche."
          },
          "seo_description": {
            "type": "string",
            "description": "La description pour les moteurs de recherche."
          },
          "certifications": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "La liste des certifications et labels, par exemple [\"CE\", \"ISO 9001\"]."
          },
          "price_tiers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PriceTier"
            },
            "description": "Les paliers de prix dégressifs HT, par exemple [{\"min_quantity\": 10, \"unit_price\": 95}]. Un palier au moins égal au prix de base est écarté."
          },
          "images": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "format": "uri",
              "maxLength": 2000
            },
            "description": "Les adresses web des photos (JPEG, PNG ou WebP, 10 Mo au plus), cinq au plus. La première devient la photo principale. Elles sont téléchargées après l'enregistrement."
          },
          "specifications": {
            "type": "object",
            "description": "Les caractéristiques de la famille, en objet clé et valeur.",
            "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": "Ajoutez dry_run=1 à un appel d'écriture : le lot est contrôlé comme il le serait, et la réponse rend le même rapport (créations, mises à jour, refus détaillés), mais rien n'est écrit, ni annonce, ni stock, ni passage au journal. Tout jeton le permet : c'est le jeton d'essai du premier branchement."
          }
        }
      },
      "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"
          }
        }
      }
    }
  }
}