{
  "openapi": "3.0.3",
  "info": {
    "title": "Conv2pdf API",
    "version": "1.1.0",
    "description": "API REST de conversion et de manipulation de PDF, hébergée dans l'UE (France, OVHcloud), conforme RGPD, DPA sur demande. Aucun service tiers hors UE n'intervient dans le traitement. Les fichiers d'entrée et de sortie sont supprimés au bout d'une heure, aucun résultat n'est mis en cache. Seule exception propre à l'API : le fichier d'une conversion en échec est conservé 72 heures pour diagnostic, puis supprimé. Le partage relève du site : le titulaire du compte peut y créer un lien de partage pour un job — y compris produit par l'API — et ce fichier vit alors jusqu'à l'échéance du lien ou jusqu'à sa révocation.\n\nAuthentification par clé API (`Authorization: Bearer cpdf_live_...`), à créer depuis le tableau de bord. Un même endpoint `POST /convert/{tool}` expose les 20 outils ; le format de sortie dépend de l'outil.",
    "termsOfService": "https://conv2pdf.com/legal/cgv/",
    "contact": {
      "name": "Conv2pdf",
      "url": "https://conv2pdf.com/contact/",
      "email": "contact@conv2pdf.com"
    }
  },
  "servers": [
    { "url": "https://api.conv2pdf.com/v1", "description": "Production" }
  ],
  "security": [{ "bearerAuth": [] }],
  "tags": [
    { "name": "Conversion", "description": "Conversion et manipulation de fichiers" },
    { "name": "Jobs", "description": "Récupération, statut et suppression des jobs" },
    { "name": "Compte", "description": "État du quota de la clé API" }
  ],
  "paths": {
    "/tools": {
      "get": {
        "tags": ["Conversion"],
        "summary": "Liste des outils disponibles",
        "description": "Renvoie la liste des 20 outils, leurs bornes de fichiers et extensions acceptées. Source machine de référence pour les intégrations.",
        "operationId": "listTools",
        "responses": {
          "200": {
            "description": "Liste des outils",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ToolsList" }
              }
            }
          },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    },
    "/quota": {
      "get": {
        "tags": ["Compte"],
        "summary": "État du quota de la clé",
        "description": "Renvoie l'objet `quota` de la clé (plan, consommé, plafonds, échéances), le même que celui de `POST /convert/{tool}`. Gratuit et sans effet : c'est l'appel à utiliser pour valider une clé, par exemple dans le test d'identifiants d'un connecteur. Répond 200 aussi quand le quota est au plafond (`status: hard_cap`) ou que l'essai Dev a expiré (`credits_expire_at` passé), là où les conversions répondent 429 ou 402.",
        "operationId": "getQuota",
        "responses": {
          "200": {
            "description": "État du quota",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Quota" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    },
    "/convert/{tool}": {
      "post": {
        "tags": ["Conversion"],
        "summary": "Convertir ou manipuler un fichier",
        "description": "Effectue une conversion synchrone. Le fichier est envoyé en `multipart/form-data`. La réponse est un JSON contenant l'URL de téléchargement du résultat (récupérable via `GET /download/{jobId}` pendant 1 heure).\n\nCertains outils acceptent des champs de formulaire supplémentaires (voir la propriété `file` et les champs optionnels ci-dessous). `merge-pdf` accepte le champ `file` répété (2 à 20 fichiers).\n\n`split-pdf` rend chaque page dans son fichier (`page-001.pdf`, `page-002.pdf`…), réunis dans une archive ZIP : il ne prend aucun champ, et refuse un PDF de plus de 200 pages. `extract-pages` rend les pages demandées dans un seul PDF, dans l'ordre écrit. Dans les deux cas le résultat ne porte que ces pages : ni les pages écartées, ni les pièces jointes, ni les métadonnées du document.\n\nJusqu'en octobre 2026, l'extraction s'appelait `split-pdf`. Un appel `split-pdf` qui porte un champ `ranges` est toujours servi comme `extract-pages` : une intégration existante n'a rien à changer. Un seul écart : les pages sortent dans l'ordre écrit (`5,1,3` rend les pages 5, 1 et 3), et non plus triées.\n\n`html-to-pdf` et `url-to-pdf` rendent la version IMPRIMABLE d'une page web (CSS d'impression) : le texte reste sélectionnable, les liens cliquables, et les titres deviennent des signets. Le format et les marges viennent du `@page` du document ; A4 avec 1 cm de marge à défaut. `html-to-pdf` prend un fichier `.html` ; `url-to-pdf` ne prend AUCUN fichier, mais le champ `url`. Dans les deux cas la page n'a accès ni aux fichiers locaux ni aux réseaux privés, le contenu d'une iframe d'une autre origine n'est pas imprimé (zone vide, sans erreur), et une sortie où rien n'est dessiné est refusée en 422 plutôt que livrée en page blanche. Plafond : 500 pages.",
        "operationId": "convert",
        "parameters": [
          {
            "name": "tool",
            "in": "path",
            "required": true,
            "description": "Identifiant de l'outil.",
            "schema": {
              "type": "string",
              "enum": [
                "image-to-pdf",
                "heic-to-jpg",
                "heic-to-pdf",
                "office-to-pdf",
                "epub-to-pdf",
                "xps-to-pdf",
                "ps-to-pdf",
                "url-to-pdf",
                "html-to-pdf",
                "merge-pdf",
                "split-pdf",
                "extract-pages",
                "compress-pdf",
                "protect-pdf",
                "pdf-to-word",
                "pdf-to-image",
                "rotate-pdf",
                "unlock-pdf",
                "watermark-pdf",
                "page-numbers-pdf"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "Fichier d'entrée. Obligatoire pour tous les outils SAUF `url-to-pdf`, qui n'en prend aucun et attend le champ `url` à la place (un fichier envoyé à `url-to-pdf` est refusé en 400 `no_file_expected`). Extensions acceptées selon l'outil (cf. `GET /tools`). Taille max 10 Mo par fichier sur le plan Dev, 200 Mo sur les plans payants. Pour `merge-pdf`, répéter le champ `file` (2 fichiers sur le plan Dev, jusqu'à 20 sur les plans payants)."
                  },
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2048,
                    "example": "https://exemple.com/article",
                    "description": "Adresse de la page à convertir. **Obligatoire pour `url-to-pdf`**, ignorée par les autres outils. Schémas `http` et `https` seulement. Sont refusées en 422 `invalid_url` : une adresse portant des identifiants (`http://utilisateur:motdepasse@hôte/`), une adresse de réseau privé, de loopback ou de lien-local, et un nom qui ne désigne qu'un réseau local ; le motif est dans `cause`. La page est ouverte sans session : tout ce qui demande une connexion est hors de portée."
                  },
                  "ranges": {
                    "type": "string",
                    "description": "`extract-pages` (requis) : pages à garder, ex. `1-5,7,10-12`. Elles sortent dans l'ordre écrit, chacune une seule fois ; `11-` va jusqu'à la dernière page, `-4` part de la première. Envoyé à `split-pdf`, ce champ fait servir l'appel comme `extract-pages`.",
                    "example": "1-5,7,10-12"
                  },
                  "quality": {
                    "type": "string",
                    "enum": ["low", "medium", "high"],
                    "default": "medium",
                    "description": "`compress-pdf` : niveau de compression (low = 72 DPI, medium = 150 DPI, high = 300 DPI)."
                  },
                  "password": {
                    "type": "string",
                    "description": "`protect-pdf` (requis, 6 à 64 caractères) : mot de passe à poser. `unlock-pdf` : mot de passe actuel du PDF, à retirer ; à omettre pour un PDF qui s'ouvre sans mot de passe mais restreint l'impression ou la copie. `pdf-to-word`, `pdf-to-image`, `compress-pdf`, `split-pdf`, `extract-pages`, `rotate-pdf`, `watermark-pdf`, `page-numbers-pdf` : mot de passe d'un PDF qui en demande un pour s'ouvrir ; le résultat n'en a plus."
                  },
                  "prevent_print": {
                    "type": "string",
                    "enum": ["on"],
                    "description": "`protect-pdf` (optionnel) : interdit l'impression."
                  },
                  "prevent_copy": {
                    "type": "string",
                    "enum": ["on"],
                    "description": "`protect-pdf` (optionnel) : interdit la copie de texte."
                  },
                  "rotation": {
                    "type": "string",
                    "enum": ["90", "180", "270"],
                    "description": "`rotate-pdf` (requis) : angle de rotation en degrés (horaire)."
                  },
                  "text": {
                    "type": "string",
                    "description": "`watermark-pdf` (requis, max 50 caractères) : texte du filigrane.",
                    "example": "CONFIDENTIEL"
                  },
                  "format": {
                    "type": "string",
                    "description": "`pdf-to-image` : `png` (défaut) ou `jpg`. `page-numbers-pdf` : `full` (défaut, « X sur N ») ou `simple` (« X » seul)."
                  },
                  "position": {
                    "type": "string",
                    "enum": ["bottom-center", "bottom-left", "bottom-right"],
                    "default": "bottom-center",
                    "description": "`page-numbers-pdf` (optionnel) : position du numéro."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Conversion réussie",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ConvertSuccess" }
              }
            }
          },
          "400": { "$ref": "#/components/responses/BadRequest" },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "402": { "$ref": "#/components/responses/PlanLimit" },
          "404": { "$ref": "#/components/responses/ToolNotFound" },
          "413": { "$ref": "#/components/responses/PayloadTooLarge" },
          "415": { "$ref": "#/components/responses/UnsupportedMedia" },
          "422": { "$ref": "#/components/responses/UnprocessableEntity" },
          "429": { "$ref": "#/components/responses/QuotaExceeded" },
          "500": { "$ref": "#/components/responses/ServerError" },
          "503": { "$ref": "#/components/responses/ServerBusy" },
          "504": { "$ref": "#/components/responses/GatewayTimeout" }
        }
      }
    },
    "/download/{jobId}": {
      "get": {
        "tags": ["Jobs"],
        "summary": "Télécharger le fichier converti",
        "description": "Renvoie le fichier de sortie avec son type MIME (`application/pdf`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document` pour PDF → Word, `image/jpeg` pour HEIC → JPG, `application/zip` pour PDF → Image et pour `split-pdf`) et `Cache-Control: no-store`. Disponible 1 heure après la conversion.",
        "operationId": "download",
        "parameters": [{ "$ref": "#/components/parameters/JobId" }],
        "responses": {
          "200": {
            "description": "Fichier binaire",
            "content": {
              "application/octet-stream": {
                "schema": { "type": "string", "format": "binary" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "403": { "$ref": "#/components/responses/Forbidden" },
          "404": { "$ref": "#/components/responses/JobNotFound" },
          "409": { "$ref": "#/components/responses/JobNotReady" },
          "410": { "$ref": "#/components/responses/Gone" },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    },
    "/job/{jobId}": {
      "get": {
        "tags": ["Jobs"],
        "summary": "Statut et métadonnées d'un job",
        "description": "Renvoie le statut d'un job (utile pour vérifier qu'une conversion est prête avant de télécharger).",
        "operationId": "getJob",
        "parameters": [{ "$ref": "#/components/parameters/JobId" }],
        "responses": {
          "200": {
            "description": "Statut du job",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/JobStatus" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "403": { "$ref": "#/components/responses/Forbidden" },
          "404": { "$ref": "#/components/responses/JobNotFound" },
          "409": { "$ref": "#/components/responses/JobNotReady" },
          "410": { "$ref": "#/components/responses/Gone" },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      },
      "delete": {
        "tags": ["Jobs"],
        "summary": "Supprimer un job",
        "description": "Supprime immédiatement un job et son fichier, sans attendre l'expiration automatique (1 heure).",
        "operationId": "deleteJob",
        "parameters": [{ "$ref": "#/components/parameters/JobId" }],
        "responses": {
          "200": {
            "description": "Job supprimé",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": { "status": { "type": "string", "example": "deleted" } }
                }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "403": { "$ref": "#/components/responses/Forbidden" },
          "404": { "$ref": "#/components/responses/JobNotFound" },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Clé API au format `cpdf_live_...`, créée depuis le tableau de bord. En-tête `Authorization: Bearer cpdf_live_...`."
      }
    },
    "parameters": {
      "JobId": {
        "name": "jobId",
        "in": "path",
        "required": true,
        "description": "Identifiant du job renvoyé par `POST /convert/{tool}`.",
        "schema": { "type": "string" }
      }
    },
    "schemas": {
      "ToolsList": {
        "type": "object",
        "properties": {
          "tools": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string", "example": "pdf-to-word" },
                "min_files": { "type": "integer", "example": 1 },
                "max_files": { "type": "integer", "example": 1 },
                "accepted_exts": {
                  "type": "array",
                  "items": { "type": "string" },
                  "example": [".pdf"]
                }
              }
            }
          }
        }
      },
      "ConvertSuccess": {
        "type": "object",
        "properties": {
          "job_id": { "type": "string", "example": "abc123def456" },
          "status": { "type": "string", "enum": ["success"] },
          "download_url": { "type": "string", "example": "/v1/download/abc123def456" },
          "size_bytes": { "type": "integer", "example": 124533 },
          "quota": {
            "$ref": "#/components/schemas/Quota",
            "description": "Présent uniquement pour les appels authentifiés par clé API."
          }
        }
      },
      "Quota": {
        "type": "object",
        "description": "État du quota du compte. Sur les plans payants, le quota est mensuel, sur un cycle anniversaire : `quota_period_end` = timestamp de la prochaine remise à zéro, c'est la seule valeur sur laquelle caler un back-off. `period_end` est la borne de FACTURATION, identique à `quota_period_end` en mensuel mais située jusqu'à douze mois plus loin en annuel. Sur le plan Dev, les 300 conversions offertes à l'inscription ne se renouvellent pas et l'essai n'est pas facturé : `quota_period_end` ET `period_end` valent `null`, et le corps porte `upgrade`, le plan qui rouvre l'accès. Un dépassement de 10 % est toléré (`soft_cap_limit`) avant blocage en 429.",
        "properties": {
          "plan": { "type": "string", "example": "starter" },
          "quota": { "type": "integer", "example": 1000 },
          "used": { "type": "integer", "example": 42 },
          "soft_cap_limit": { "type": "integer", "example": 1100 },
          "status": { "type": "string", "enum": ["ok", "soft_cap", "hard_cap"] },
          "period_end": { "type": "integer", "format": "int64", "nullable": true, "example": 1715789012345, "description": "`null` sur le plan Dev : l'essai n'est pas facturé, il n'a donc pas de borne de facturation." },
          "quota_period_end": { "type": "integer", "format": "int64", "nullable": true, "example": 1715789012345, "description": "`null` sur le plan Dev : crédits d'essai, sans renouvellement." },
          "credits_expire_at": { "type": "integer", "format": "int64", "nullable": true, "example": null, "description": "Plan Dev : fin de validité des crédits d'essai (douze mois depuis leur octroi). `null` sur les plans payants." }
        }
      },
      "JobStatus": {
        "type": "object",
        "description": "Renvoyé uniquement pour un job terminé avec succès (sinon 409 `job_not_ready`, ou 410 `job_deleted` si le job a été supprimé).",
        "properties": {
          "job_id": { "type": "string" },
          "status": { "type": "string", "enum": ["success"] },
          "tool": { "type": "string", "example": "pdf-to-word" },
          "size_bytes": { "type": "integer", "example": 124533 },
          "completed_at": { "type": "integer", "format": "int64" },
          "expires_at": { "type": "integer", "format": "int64", "description": "Timestamp de suppression automatique du fichier." },
          "download_url": { "type": "string", "example": "/v1/download/abc123" },
          "can_share": { "type": "boolean" }
        }
      },
      "Error": {
        "type": "object",
        "required": ["error"],
        "properties": {
          "error": { "type": "string", "description": "Code d'erreur stable, lisible par machine." }
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Nombre de fichiers hors bornes (`not_enough_files`, `too_many_files`), champ requis vide (`field_required`), fichier envoyé à un outil qui n'en prend aucun (`no_file_expected`, sur `url-to-pdf` : c'est le champ `url` qu'il attend), paramètre hors des valeurs acceptées (`invalid_rotation`, `invalid_page_range`, `invalid_quality`, `invalid_format`), mot de passe hors bornes sur `protect-pdf` (`password_too_short`, `password_too_long`). Sur `invalid_page_range`, le corps porte le motif dans `cause` (`syntax`, `page_zero`, `beyond_last_page` ou `whole_document`), le morceau refusé dans `range` et, une fois le PDF ouvert, son nombre de pages dans `total_pages`. Aucun de ces refus n'est décompté du quota.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "Unauthorized": {
        "description": "Auth manquante ou clé invalide (`missing_bearer_token`, `invalid_api_key`).",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "PlanLimit": {
        "description": "Limite du plan atteinte. `plan_limit_files` : plus de fichiers que le plan n'en autorise (le corps porte `max_allowed`). `credits_expired` : crédits d'essai Dev passés leur date de validité (douze mois depuis leur octroi), quel que soit le reliquat ; le corps porte `expired_at` et `upgrade`. Aucun outil n'est réservé aux plans payants : les 20 outils sont servis sur tous les plans, essai compris.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "Forbidden": {
        "description": "Le job appartient à une autre clé (`forbidden`).",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "ToolNotFound": {
        "description": "Outil inexistant (`tool_not_found`).",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "JobNotFound": {
        "description": "Job inexistant (`job_not_found`).",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "JobNotReady": {
        "description": "Le job existe mais n'a pas de sortie téléchargeable (`job_not_ready`) : conversion en cours, échouée ou rejetée. Le corps porte `status`. Un job supprimé répond 410, pas 409.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "Gone": {
        "description": "Ressource partie définitivement : fichier purgé au TTL de 1 h (`file_expired`), ou job supprimé via `DELETE /v1/job/{jobId}` (`job_deleted`). Inutile de retenter.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "PayloadTooLarge": {
        "description": "Fichier au-delà de la limite du plan — 10 Mo sur Dev, 200 Mo sur les plans payants (`file_too_large`). Quand un plan supérieur accepterait le fichier, la réponse porte `upgrade` : ce plan, son prix mensuel HT et son plafond.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "file_too_large", "max_bytes": 10485760, "file": "contrat.pdf", "plan": "dev", "upgrade": { "plan": "starter", "price_eur_month": 9, "quota": 1000, "url": "https://conv2pdf.com/api/tarifs/", "max_bytes": 209715200 } } } }
      },
      "UnsupportedMedia": {
        "description": "Deux cas. `unsupported_media_type` : le `Content-Type` de la requête n'est pas parsable — les conversions s'envoient en `multipart/form-data`, et la réponse porte `received` et `accepted`. `unsupported_content` : contenu du fichier incompatible avec l'outil, type déterminé au contenu et pas à l'extension du nom, la réponse porte `detected_type` (les fichiers Numbers et Keynote sont refusés en `iwork_numbers` et `iwork_keynote`).",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "UnprocessableEntity": {
        "description": "Fichier vide (`empty_file`), fichier chiffré (`password_protected` : PDF, livre EPUB sous DRM, document iWork verrouillé), mot de passe manquant ou refusé (`needs_password`, `wrong_password`), PDF sans protection ou déjà protégé (`pdf_not_protected`, `pdf_already_protected`), PDF scanné sans couche texte pour PDF → Word (`pdf_scanned_needs_ocr`), trop de pages (`pdf_too_many_pages`, `too_many_pages`), PDF d'une seule page envoyé à `split-pdf` (`pdf_single_page`), livre EPUB dont les pages sortiraient blanches (`epub_blank_output`) ou de plus de 1 500 pages (`epub_too_long`), fichier PostScript qui ne dessine aucune page (`ps_blank_output`), page web qui ne rend aucun contenu (`html_blank_output` pour un fichier, `url_blank_page` pour une adresse), adresse refusée avant le moteur (`invalid_url`, avec le motif dans `cause`), adresse qui ne répond pas (`url_unreachable`), page qui répond par une erreur HTTP (`url_http_error`, statut de la page dans `http_status`), adresse désignée comme réseau privé par la garde du moteur (`url_blocked`), texte de filigrane sans caractère imprimable (`unsupported_characters`), fichier illisible (`source_unreadable`), sortie trop volumineuse (`output_too_large`). Sont décomptés du quota les refus rendus après lecture du fichier : `pdf_not_protected`, `pdf_already_protected`, `pdf_scanned_needs_ocr`, `pdf_too_many_pages`, `too_many_pages`, `pdf_single_page`, `epub_blank_output`, `epub_too_long`, `ps_blank_output`, `html_blank_output`, `url_blank_page`, `url_unreachable`, `url_http_error`, `url_blocked`, `source_unreadable` et `output_too_large`. Les autres ne coûtent rien, `invalid_url` compris — c'est un refus de paramètre, comme une rotation hors valeurs.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "QuotaExceeded": {
        "description": "Deux cas. `quota_exceeded` : quota atteint — sur les plans payants, voir `soft_cap_limit` et `quota_period_end` (date du prochain rechargement), inutile de retenter avant ; sur Dev, `quota_period_end` ET `period_end` valent `null` (rien ne se renouvelle, rien n'est facturé) et le corps porte `upgrade`, le plan qui rouvre l'accès. `rate_limited` : débit dépassé, 20 appels par minute et par clé sur cet endpoint — la réponse porte `retry_after` (secondes) et `limit`, plus l'en-tête `Retry-After`, et le quota n'est pas décompté.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "RateLimited": {
        "description": "Débit dépassé (`rate_limited`) : 300 requêtes par minute et par IP. La réponse porte `retry_after` (secondes) et `limit`, plus l'en-tête `Retry-After`.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "rate_limited", "retry_after": 42, "limit": 300 } } }
      },
      "ServerBusy": {
        "description": "File de conversion saturée, réessayer sous 5 s (`server_busy`, en-tête `Retry-After`).",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "ServerError": {
        "description": "Erreur de conversion serveur (`conversion_failed`) : le corps porte `job_id` et `status: \"failed\"`. La tentative n'est pas décomptée du quota.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }
      },
      "GatewayTimeout": {
        "description": "Budget de temps du moteur dépassé (`conversion_timeout`) : le corps porte `timeout_ms`, et le job est `failed`. La tentative n'est pas décomptée du quota.",
        "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "job_id": "abc123def456", "status": "failed", "error": "conversion_timeout", "timeout_ms": 30000 } } }
      }
    }
  }
}
