feat(locadex): continuous i18n

es/api-playground/overview.mdx

@@ -1,13 +1,13 @@
 ---
 title: "Zona de pruebas"
 description: "Permite que los usuarios interactúen con tu API"
 ---
 
 <div id="overview">
   ## Descripción general
 </div>
 
 El área de pruebas de la API es un entorno interactivo que permite a los usuarios probar y explorar tus endpoints de API. Los desarrolladores pueden elaborar solicitudes a la API, enviarlas y ver las respuestas sin salir de tu documentación.
 
 <Frame>
   <img src="/images/playground/API-playground-light.png" alt="Área de pruebas de la API para el endpoint que desencadena una actualización." className="block dark:hidden" />
@@ -15,18 +15,18 @@
   <img src="/images/playground/API-playground-dark.png" alt="Área de pruebas de la API para el endpoint que desencadena una actualización." className="hidden dark:block" />
 </Frame>
 
 El área de pruebas se genera automáticamente a partir de tu especificación de OpenAPI o del esquema de AsyncAPI, por lo que cualquier actualización de tu API se refleja automáticamente en el área de pruebas. También puedes crear manualmente páginas de referencia de la API después de definir una URL base y un método de Autenticación en tu `docs.json`.
 
 Recomendamos generar tu área de pruebas de la API a partir de una especificación de OpenAPI. Consulta [OpenAPI Setup](/es/api-playground/openapi-setup) para obtener más información sobre cómo crear tu documento de OpenAPI.
 
 <div id="getting-started">
   ## Primeros pasos
 </div>
 
 <Steps>
   <Step title="Añade tu archivo de especificación OpenAPI.">
     <Info>
       Asegúrate de que tu archivo de especificación OpenAPI sea válido usando el [Swagger Editor](https://editor.swagger.io/) o la [CLI de Mint](https://www.npmjs.com/package/mint).
     </Info>
 
     ```bash {3}
@@ -37,7 +37,7 @@
   </Step>
 
   <Step title="Configura `docs.json`.">
     Actualiza tu `docs.json` para hacer referencia a tu especificación OpenAPI. Añade una propiedad `openapi` a cualquier elemento de navigation para completar automáticamente tu documentación con páginas para cada endpoint especificado en tu documento OpenAPI.
 
     Este ejemplo genera una página para cada endpoint especificado en `openapi.json` y las organiza en el grupo &quot;API reference&quot; dentro de tu navigation.
 
@@ -74,37 +74,37 @@
 </Steps>
 
 <div id="customizing-your-playground">
-  ## Personalización del área de pruebas
+  ## Personaliza tu área de pruebas
 </div>
 
 Puedes personalizar tu área de pruebas de la API definiendo las siguientes propiedades en tu `docs.json`.
 
 <ResponseField name="playground" type="object">
-  Configuraciones del área de pruebas de la API.
+  Configuración del área de pruebas de la API.
 
   <Expandable title="playground" defaultOpen="True">
     <ResponseField name="display" type="&#x22;interactive&#x22; | &#x22;simple&#x22; | &#x22;none&#x22;">
-      El modo de visualización del área de pruebas de la API.
+      Modo de visualización del área de pruebas de la API.
 
       * `"interactive"`: Muestra el área de pruebas interactiva.
-      * `"simple"`: Muestra un endpoint que se puede copiar, sin área de pruebas.
+      * `"simple"`: Muestra un endpoint copiable sin área de pruebas.
       * `"none"`: No muestra nada.
 
       El valor predeterminado es `interactive`.
     </ResponseField>
 
     <ResponseField name="proxy" type="boolean" defaultOpen="True">
-      Indica si se deben enviar las solicitudes de la API a través de un servidor proxy. De manera predeterminada es `true`.
+      Indica si se deben pasar las solicitudes de la API a través de un servidor proxy. De manera predeterminada es `true`.
     </ResponseField>
   </Expandable>
 </ResponseField>
 
 <ResponseField name="examples" type="object">
-  Configuraciones para los ejemplos de API generados automáticamente.
+  Configuración de los ejemplos de API generados automáticamente.
 
   <Expandable title="examples" defaultOpen="True">
     <ResponseField name="languages" type="array of string">
       Idiomas para los fragmentos de API generados automáticamente.
 
       Los idiomas se muestran en el orden especificado.
     </ResponseField>
@@ -112,11 +112,15 @@
     <ResponseField name="defaults" type="&#x22;required&#x22; | &#x22;all&#x22;">
       Indica si se deben mostrar los parámetros opcionales en los ejemplos de la API. De manera predeterminada es `all`.
     </ResponseField>
+
+    <ResponseField name="prefill" type="boolean">
+      Indica si se debe rellenar previamente el área de pruebas de la API con datos de ejemplos del esquema. Cuando está activado, el área de pruebas completa automáticamente los campos de la solicitud con valores de ejemplo de tu especificación de OpenAPI. De manera predeterminada es `false`.
+    </ResponseField>
   </Expandable>
 </ResponseField>
 
 <div id="example-configuration">
   ### Ejemplo de configuración
 </div>
 
 ```json
@@ -127,33 +131,34 @@
    },
    "examples": {
      "languages": ["curl", "python", "javascript"],
-     "defaults": "required"
+     "defaults": "required",
+     "prefill": true
    }
  }
 }
 ```
 
-Este ejemplo configura el área de pruebas de la API para que sea interactiva, con fragmentos de código de ejemplo para cURL, Python y JavaScript. Solo se muestran los parámetros obligatorios en los fragmentos de código.
+Este ejemplo configura el área de pruebas de la API para que sea interactiva, con fragmentos de código de ejemplo para cURL, Python y JavaScript. En los fragmentos de código solo se muestran los parámetros obligatorios, y el área de pruebas rellena previamente el cuerpo de la solicitud con valores de ejemplo.
 
 <div id="custom-endpoint-pages">
   ### Páginas de endpoints personalizadas
 </div>
 
 Cuando necesites más control sobre tu documentación de API, usa la extensión `x-mint` en tu especificación de OpenAPI o crea páginas `MDX` individuales para tus endpoints.
 
 Ambas opciones te permiten:
 
 * Personalizar los metadatos de la página
 * Añadir contenido adicional, como ejemplos
 * Controlar el comportamiento del playground por página
 
 Se recomienda la extensión `x-mint` para que toda tu documentación de API se genere automáticamente a partir de tu especificación de OpenAPI y se mantenga en un solo archivo.
 
 Se recomiendan las páginas `MDX` individuales para APIs pequeñas o cuando quieras probar cambios por página.
 
 Para más información, consulta [Extensión x-mint](/es/api-playground/openapi-setup#x-mint-extension) y [Configuración de MDX](/es/api-playground/mdx/configuration).
 
 <div id="further-reading">
   ## Lecturas adicionales
 </div>
 

es/organize/settings.mdx

@@ -1,22 +1,22 @@
 ---
 title: "Configuración global"
 description: "Configura la configuración del sitio con el archivo `docs.json`"
 keywords: ["docs.json", "configuración", "personalización", "ajustes"]
 ---
 
 import IconsOptional from "/snippets/es/icons-optional.mdx";
 
 El archivo `docs.json` te permite convertir una colección de archivos Markdown en un sitio de documentación navegable y personalizado. Este archivo de configuración obligatorio controla el estilo, la navigation, las integrations y más. Piénsalo como el plano de tu documentación.
 
 La configuración en `docs.json` se aplica globalmente a todas las páginas.
 
 <div id="setting-up-your-docsjson">
   ## Configurar tu `docs.json`
 </div>
 
 Para empezar, solo necesitas especificar `theme`, `name`, `colors.primary` y `navigation`. Los demás campos son opcionales y puedes añadirlos a medida que crezcan las necesidades de tu documentación.
 
 Para obtener la mejor experiencia de edición, incluye la referencia del esquema en la parte superior de tu archivo `docs.json`. Esto habilita el autocompletado, la validación y sugerencias útiles en la mayoría de los editores de código:
 
 ```json
 {
@@ -29,7 +29,7 @@
   "navigation": {
     // Tu estructura de navegación
   }
   // El resto de tu configuración
 }
 ```
 
@@ -44,7 +44,7 @@
 </div>
 
 <ResponseField name="theme" required>
   El tema de diseño de tu sitio.
 
   Una de las siguientes: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`.
 
@@ -56,11 +56,11 @@
 </ResponseField>
 
 <ResponseField name="colors" type="object" required>
   Los colores que usa tu documentación. Los colores se aplican de forma diferente según el tema. Si solo proporcionas un color principal, se usará para todos los elementos de color.
 
   <Expandable title="Colors">
     <ResponseField name="primary" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$" required>
       El color principal de tu documentación. Generalmente se usa para resaltar en modo claro, con algunas variaciones según el tema.
 
       Debe ser un código hexadecimal que comience con `#`.
     </ResponseField>
@@ -74,7 +74,7 @@
     <ResponseField name="dark" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$">
       El color utilizado para botones y estados hover en modo claro y oscuro, con algunas variaciones según el tema.
 
       Debe ser un código hexadecimal que comience con `#`.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -89,7 +89,7 @@
   <Expandable title="Logo">
     <ResponseField name="light" type="string" required>
       Ruta al archivo de tu logotipo para el modo claro. Incluye la extensión del archivo. Ejemplo: `/logo.png`
     </ResponseField>
 
     <ResponseField name="dark" type="string" required>
       Ruta al archivo de tu logotipo para el modo oscuro. Incluye la extensión del archivo. Ejemplo: `/logo-dark.png`
@@ -102,7 +102,7 @@
 </ResponseField>
 
 <ResponseField name="favicon" type="string or object">
   Ruta a tu archivo de favicon, incluida la extensión. Se redimensiona automáticamente a los tamaños de favicon adecuados.
   Puede ser un único archivo o archivos separados para los modos claro y oscuro. Ejemplo: `/favicon.png`
 
   <Expandable title="Favicon">
@@ -121,7 +121,7 @@
 
   <Expandable title="Thumbnails">
     <ResponseField name="appearance" type="&#x22;light&#x22; | &#x22;dark&#x22;">
       El tema visual de tus miniaturas. Si no se especifica, las miniaturas usan el esquema de color de tu sitio definido en el campo `colors`.
     </ResponseField>
 
     <ResponseField name="background" type="string">
@@ -135,11 +135,11 @@
 
   <Expandable title="Styling">
     <ResponseField name="eyebrows" type="&#x22;section&#x22; | &#x22;breadcrumbs&#x22;">
       El estilo del “eyebrow” de la página. Elige `section` para mostrar el nombre de la sección o `breadcrumbs` para mostrar la ruta completa de navegación. De forma predeterminada es `section`.
     </ResponseField>
 
     <ResponseField name="codeblocks" type="&#x22;system&#x22; | &#x22;dark&#x22; | string | object">
       Configuración del tema de los bloques de código. De forma predeterminada es `"system"`.
 
       **Configuración simple:**
 
@@ -152,7 +152,7 @@
       * Usa un objeto para especificar [temas de Shiki](https://shiki.style/themes) separados para los modos claro y oscuro
 
       <ResponseField name="theme" type="string">
         Un único nombre de tema de Shiki para usar tanto en modo claro como oscuro.
 
         ```json
         "styling": {
@@ -192,11 +192,11 @@
 </ResponseField>
 
 <ResponseField name="icons" type="object">
   Configuración de la biblioteca de iconos.
 
   <Expandable title="Icons">
     <ResponseField name="library" type="&#x22;fontawesome&#x22; | &#x22;lucide&#x22;" required>
       Biblioteca de iconos para usar en toda tu documentación. De forma predeterminada es `fontawesome`.
 
       <Note>
         Puedes especificar una URL a un icono alojado externamente, la ruta a un archivo de icono en tu proyecto o código SVG compatible con JSX para cualquier icono individual, independientemente de la configuración de la biblioteca.
@@ -206,12 +206,12 @@
 </ResponseField>
 
 <ResponseField name="fonts" type="object">
   Configuración tipográfica para tu documentación. La fuente predeterminada es [Inter](https://fonts.google.com/specimen/Inter).
 
   <Expandable title="Fuentes">
     <ResponseField name="family" type="string" required>
       Familia tipográfica, por ejemplo, &quot;Open Sans&quot;.
     </ResponseField>
 
     <ResponseField name="weight" type="number">
       Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
@@ -260,7 +260,7 @@
         </ResponseField>
 
         <ResponseField name="source" type="string (uri)">
           URL del archivo de tu fuente, por ejemplo, https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) se cargan automáticamente cuando especificas un nombre de `family` de Google Fonts, por lo que no se necesita una URL de fuente.
         </ResponseField>
 
         <ResponseField name="format" type="&#x22;woff&#x22; | &#x22;woff2&#x22;">
@@ -272,11 +272,11 @@
 </ResponseField>
 
 <ResponseField name="appearance" type="object">
   Configuración del conmutador de modo claro/oscuro.
 
   <Expandable title="Apariencia">
     <ResponseField name="default" type="&#x22;system&#x22; | &#x22;light&#x22; | &#x22;dark&#x22;">
       Modo de tema predeterminado. Elige `system` para ajustarlo a la configuración del sistema operativo del usuario, o `light` o `dark` para forzar un modo específico. De manera predeterminada es `system`.
     </ResponseField>
 
     <ResponseField name="strict" type="boolean">
@@ -286,11 +286,11 @@
 </ResponseField>
 
 <ResponseField name="background" type="object">
   Configuración del color y la decoración del fondo.
 
   <Expandable title="Background">
     <ResponseField name="image" type="string or object">
       Imagen de fondo para tu sitio. Puede ser un único archivo o archivos separados para los modos light y dark.
 
       <Expandable title="Image">
         <ResponseField name="light" type="string" required>
@@ -328,15 +328,15 @@
 </ResponseField>
 
 <div id="structure">
   ### Estructura
 </div>
 
 <ResponseField name="navbar" type="object">
   Elementos de la barra de navegación que apuntan a enlaces externos.
 
   <Expandable title="Navbar">
     <ResponseField name="links" type="array of object">
       Enlaces que se mostrarán en la barra de navegación.
 
       <Expandable title="Enlaces">
         <ResponseField name="label" type="string" required>
@@ -364,7 +364,7 @@
         </ResponseField>
 
         <ResponseField name="href" type="string (uri)" required>
           Destino del botón. Debe ser una URL externa. Si `type` es `github`, debe ser la URL de un repositorio de GitHub.
         </ResponseField>
       </Expandable>
     </ResponseField>
@@ -372,11 +372,11 @@
 </ResponseField>
 
 <ResponseField name="navigation" type="object" required>
   La estructura de navegación de tu contenido.
 
   <Expandable title="Navegación">
     <ResponseField name="global" type="object">
       Elementos de navegación globales que aparecen en todas las páginas y secciones.
 
       <Expandable title="Global">
         <ResponseField name="idiomas" type="array of object">
@@ -542,21 +542,21 @@
 </ResponseField>
 
 <ResponseField name="interaction" type="object">
   Configuración de interacción del usuario para los elementos de navegación.
 
   <Expandable title="Interacción">
     <ResponseField name="drilldown" type="boolean">
       Controla el comportamiento de navegación automática al seleccionar grupos de navegación. Establece `true` para forzar la navegación a la primera página cuando se expanda un grupo de navegación. Establece `false` para evitar la navegación y solo expandir o contraer el grupo. Déjalo sin definir para usar el comportamiento predeterminado del tema.
     </ResponseField>
   </Expandable>
 </ResponseField>
 
 <ResponseField name="footer" type="object">
   Contenido del pie de página y enlaces a redes sociales.
 
   <Expandable title="Pie de página">
     <ResponseField name="socials" type="object">
       Perfiles de redes sociales para mostrar en el pie de página. Cada key es el nombre de una plataforma y cada value es la URL de tu perfil. Por ejemplo:
 
       ```json
       {
@@ -598,11 +598,11 @@
 </ResponseField>
 
 <ResponseField name="banner" type="object">
   Banner del sitio mostrado en la parte superior de las páginas.
 
   <Expandable title="Banner">
     <ResponseField name="content" type="string">
       El contenido del banner. Admite texto sin formato y formato Markdown. Por ejemplo:
 
       ```json
       {
@@ -618,11 +618,11 @@
 </ResponseField>
 
 <ResponseField name="redirects" type="array of object">
   Redirecciones para páginas movidas, renombradas o eliminadas.
 
   <Expandable title="Redirecciones">
     <ResponseField name="source" type="string" required>
       Ruta de origen desde la que redirigir. Ejemplo: `/old-page`
     </ResponseField>
 
     <ResponseField name="destination" type="string" required>
@@ -636,11 +636,11 @@
 </ResponseField>
 
 <ResponseField name="contextual" type="object">
   Menú contextual para contenido optimizado con IA e integraciones.
 
   <Expandable title="Contextual">
     <ResponseField name="options" type="array of &#x22;copy&#x22; | &#x22;view&#x22; | &#x22;chatgpt&#x22; | &#x22;claude&#x22; | &#x22;perplexity&#x22; | &#x22;mcp&#x22; | &#x22;cursor&#x22; | &#x22;vscode&#x22;" required>
       Acciones disponibles en el menú contextual. La primera opción aparece como predeterminada.
 
       * `copy`: Copia la página actual como Markdown en el portapapeles.
       * `view`: Muestra la página actual como Markdown en una nueva pestaña.
@@ -648,7 +648,7 @@
       * `claude`: Envía el contenido de la página actual a Claude.
       * `perplexity`: Envía el contenido de la página actual a Perplexity.
       * `mcp`: Copia la URL de tu servidor MCP en el portapapeles.
       * `cursor`: Instala tu servidor MCP alojado en Cursor.
       * `vscode`: Instala tu servidor MCP alojado en VSCode.
 
       <img src="/images/page-context-menu.png" alt="Menú contextual" className="rounded-xl" />
@@ -661,15 +661,15 @@
 </ResponseField>
 
 <div id="api-configurations">
   ### Configuraciones de la API
 </div>
 
 <ResponseField name="api" type="object">
   Configuración de la documentación de la API y del área de pruebas interactiva.
 
   <Expandable title="Api">
     <ResponseField name="openapi" type="string or array or object">
       Archivos de especificación OpenAPI para generar la documentación de la API. Puede ser una única URL/ruta o una matriz de URL/rutas.
 
       <Expandable title="Openapi">
         <ResponseField name="source" type="string">
@@ -679,7 +679,7 @@
         </ResponseField>
 
         <ResponseField name="directory" type="string">
-          Directorio en el que buscar archivos OpenAPI.
+          Directorio donde buscar archivos OpenAPI.
 
           No incluyas una barra inicial.
         </ResponseField>
@@ -697,7 +697,7 @@
         </ResponseField>
 
         <ResponseField name="directory" type="string">
-          Directorio en el que buscar archivos AsyncAPI.
+          Directorio donde buscar archivos AsyncAPI.
 
           No incluyas una barra inicial.
         </ResponseField>
@@ -723,7 +723,7 @@
         </ResponseField>
 
         <ResponseField name="proxy" type="boolean">
-          Indica si las solicitudes de la API se envían a través de un servidor proxy. El valor predeterminado es `true`.
+          Indica si las solicitudes de la API pasan por un servidor proxy. El valor predeterminado es `true`.
         </ResponseField>
       </Expandable>
     </ResponseField>
@@ -733,35 +733,39 @@
 
       <Expandable title="Examples">
         <ResponseField name="languages" type="array of string">
-          Idiomas de ejemplo para los fragmentos de API generados automáticamente
+          Lenguajes de ejemplo para los fragmentos de API generados automáticamente
         </ResponseField>
 
         <ResponseField name="defaults" type="&#x22;required&#x22; | &#x22;all&#x22;">
           Indica si se muestran los parámetros opcionales en los ejemplos de la API. El valor predeterminado es `all`.
         </ResponseField>
+
+        <ResponseField name="prefill" type="boolean">
+          Indica si se precarga el área de pruebas de la API con datos de ejemplos de esquemas. Cuando está habilitado, el área de pruebas completa automáticamente los campos de la solicitud con valores de ejemplo de tu especificación OpenAPI. El valor predeterminado es `false`.
+        </ResponseField>
       </Expandable>
     </ResponseField>
 
     <ResponseField name="mdx" type="object">
-      Configuración de las páginas de la API generadas a partir de archivos `MDX`.
+      Configuración para páginas de API generadas a partir de archivos `MDX`.
 
       <Expandable title="Mdx">
         <ResponseField name="auth" type="object">
           Configuración de autenticación para solicitudes de API basadas en MDX.
 
           <Expandable title="Auth">
             <ResponseField name="method" type="&#x22;bearer&#x22; | &#x22;basic&#x22; | &#x22;key&#x22; | &#x22;cobo&#x22;">
-              Método de autenticación para solicitudes de la API.
+              Método de autenticación para solicitudes de API.
             </ResponseField>
 
             <ResponseField name="name" type="string">
-              Nombre de la autenticación para solicitudes de la API.
+              Nombre de la autenticación para solicitudes de API.
             </ResponseField>
           </Expandable>
         </ResponseField>
 
         <ResponseField name="server" type="string or array">
-          Configuración del servidor para solicitudes de la API.
+          Configuración del servidor para solicitudes de API.
         </ResponseField>
       </Expandable>
     </ResponseField>
@@ -769,15 +773,15 @@
 </ResponseField>
 
 <div id="seo-and-search">
   ### SEO y búsqueda
 </div>
 
 <ResponseField name="seo" type="object">
   Configuraciones de indexación para SEO.
 
   <Expandable title="SEO">
     <ResponseField name="metatags" type="object">
       Metatags añadidos a cada página. Debe ser un par key-value válido. Consulta la [referencia de metatags comunes](/es/optimize/seo#common-meta-tags-reference) para ver las opciones.
     </ResponseField>
 
     <ResponseField name="indexing" type="&#x22;navigable&#x22; | &#x22;all&#x22;">
@@ -787,21 +791,21 @@
 </ResponseField>
 
 <ResponseField name="search" type="object">
   Configuraciones de visualización de la búsqueda.
 
   <Expandable title="Search">
     <ResponseField name="prompt" type="string">
       Texto de marcador de posición que se muestra en la barra de búsqueda.
     </ResponseField>
   </Expandable>
 </ResponseField>
 
 <div id="integrations">
   ### Integraciones
 </div>
 
 <ResponseField name="Integraciones" type="object">
   Integraciones de terceros.
 
   <Expandable title="Integraciones">
     <ResponseField name="Amplitude" type="object">
@@ -1025,21 +1029,21 @@
 </ResponseField>
 
 <div id="errors">
   ### Errores
 </div>
 
 <ResponseField name="errors" type="object">
   Configuración del manejo de errores.
 
   <Expandable title="Errores">
     <ResponseField name="404" type="object">
       Manejo del error 404 &quot;Página no encontrada&quot;.
 
       <Expandable title="404">
         <ResponseField name="redirect" type="boolean">
           Indica si se debe redirigir automáticamente a la página de inicio cuando no se
           encuentre una página.
         </ResponseField>
 
         <ResponseField name="title" type="string">
           Título personalizado para la página de error 404.
@@ -1054,7 +1058,7 @@
 </ResponseField>
 
 <div id="examples">
   ## Ejemplos
 </div>
 
 <Tabs>
@@ -1574,14 +1578,14 @@
 </Tabs>
 
 <div id="upgrading-from-mintjson">
   ## Actualización desde `mint.json`
 </div>
 
 Si tu proyecto de documentación usa el archivo `mint.json` en desuso, sigue estos pasos para actualizar a `docs.json`.
 
 <Steps>
   <Step title="Instala o actualiza la CLI">
     Si aún no has instalado la [CLI](/es/installation), instálala ahora:
 
     <CodeGroup>
       ```bash npm
@@ -1605,7 +1609,7 @@
   </Step>
 
   <Step title="Crea tu archivo docs.json">
     En tu repositorio de documentación, ejecuta:
 
     ```bash
     mint upgrade
@@ -1615,5 +1619,5 @@
   </Step>
 
   <Step title="Elimina tu archivo mint.json">
     Después de verificar que tu `docs.json` esté configurado correctamente, puedes eliminar de forma segura tu antiguo archivo `mint.json`.
   </Step>

fr/api-playground/overview.mdx

@@ -1,13 +1,13 @@
 ---
 title: "Aire de test"
 description: "Permettez aux utilisateurs d’interagir avec votre API"
 ---
 
 <div id="overview">
   ## Aperçu
 </div>
 
 Le bac à sable d’API est un environnement interactif qui permet aux utilisateurs de tester et d’explorer les points de terminaison de votre API. Les développeurs peuvent composer des requêtes API, les envoyer et consulter les réponses sans quitter votre documentation.
 
 <Frame>
   <img src="/images/playground/API-playground-light.png" alt="Bac à sable d’API pour le point de terminaison déclenchant une mise à jour." className="block dark:hidden" />
@@ -15,18 +15,18 @@
   <img src="/images/playground/API-playground-dark.png" alt="Bac à sable d’API pour le point de terminaison déclenchant une mise à jour." className="hidden dark:block" />
 </Frame>
 
 Le bac à sable est généré automatiquement à partir de votre spécification OpenAPI ou de votre schéma AsyncAPI, de sorte que toute mise à jour de votre API est automatiquement répercutée dans le bac à sable. Vous pouvez également créer manuellement des pages de référence de l’API après avoir défini une URL de base et une méthode d’authentification dans votre `docs.json`.
 
 Nous recommandons de générer votre bac à sable d’API à partir d’une spécification OpenAPI. Consultez [Configuration OpenAPI](/fr/api-playground/openapi-setup) pour plus d’informations sur la création de votre document OpenAPI.
 
 <div id="getting-started">
   ## Bien démarrer
 </div>
 
 <Steps>
   <Step title="Ajoutez votre fichier de spécification OpenAPI.">
     <Info>
       Vérifiez la validité de votre spécification OpenAPI avec le [Swagger Editor](https://editor.swagger.io/) ou la [Interface en ligne de commande (CLI) Mint](https://www.npmjs.com/package/mint).
     </Info>
 
     ```bash {3}
@@ -37,13 +37,13 @@
   </Step>
 
   <Step title="Configurez `docs.json`.">
     Mettez à jour votre `docs.json` pour référencer votre spécification OpenAPI. Ajoutez une propriété `openapi` à tout élément de navigation pour remplir automatiquement votre documentation avec des pages pour chaque endpoint défini dans votre document OpenAPI.
 
     Cet exemple génère une page pour chaque endpoint défini dans `openapi.json` et les regroupe sous « API reference » dans votre navigation.
 
     ```json
     "navigation": {
       "groups": [
         {
           "group": "API reference",
           "openapi": "openapi.json"
@@ -74,49 +74,53 @@
 </Steps>
 
 <div id="customizing-your-playground">
-  ## Personnaliser votre bac à sable
+  ## Personnalisation de votre bac à sable
 </div>
 
 Vous pouvez personnaliser votre bac à sable d’API en définissant les propriétés suivantes dans votre `docs.json`.
 
 <ResponseField name="playground" type="object">
   Paramètres de configuration du bac à sable d’API.
 
   <Expandable title="playground" defaultOpen="True">
     <ResponseField name="display" type="&#x22;interactive&#x22; | &#x22;simple&#x22; | &#x22;none&#x22;">
       Le mode d’affichage du bac à sable d’API.
 
-      * `"interactive"` : afficher le bac à sable interactif.
-      * `"simple"` : afficher un point de terminaison copiable sans bac à sable.
-      * `"none"` : ne rien afficher.
+      * `"interactive"` : affiche le bac à sable interactif.
+      * `"simple"` : affiche un endpoint copiable sans bac à sable.
+      * `"none"` : n’affiche rien.
 
       Valeur par défaut : `interactive`.
     </ResponseField>
 
     <ResponseField name="proxy" type="boolean" defaultOpen="True">
-      Indique s’il faut faire transiter les requêtes d’API par un serveur proxy. Valeur par défaut : `true`.
+      Indique s’il faut faire transiter les requêtes d’API via un serveur proxy. Valeur par défaut : `true`.
     </ResponseField>
   </Expandable>
 </ResponseField>
 
 <ResponseField name="examples" type="object">
-  Paramètres de configuration pour les exemples d’API générés automatiquement.
+  Paramètres de configuration des exemples d’API générés automatiquement.
 
   <Expandable title="examples" defaultOpen="True">
     <ResponseField name="languages" type="array of string">
-      Langages pour les extraits d’API générés automatiquement.
+      Langues d’exemples pour les extraits d’API générés automatiquement.
 
-      Les langages s’affichent dans l’ordre spécifié.
+      Les langues s’affichent dans l’ordre spécifié.
     </ResponseField>
 
     <ResponseField name="defaults" type="&#x22;required&#x22; | &#x22;all&#x22;">
       Indique s’il faut afficher les paramètres optionnels dans les exemples d’API. Valeur par défaut : `all`.
     </ResponseField>
+
+    <ResponseField name="prefill" type="boolean">
+      Indique s’il faut préremplir le bac à sable d’API avec les données issues des exemples de schéma. Lorsque cette option est activée, le bac à sable renseigne automatiquement les champs de requête avec des valeurs d’exemple provenant de votre spécification OpenAPI. Valeur par défaut : `false`.
+    </ResponseField>
   </Expandable>
 </ResponseField>
 
 <div id="example-configuration">
   ### Exemple de configuration
 </div>
 
 ```json
@@ -127,33 +131,34 @@
    },
    "examples": {
      "languages": ["curl", "python", "javascript"],
-     "defaults": "required"
+     "defaults": "required",
+     "prefill": true
    }
  }
 }
 ```
 
-Cet exemple configure le bac à sable d’API pour qu’il soit interactif, avec des extraits de code pour cURL, Python et JavaScript. Seuls les paramètres requis sont affichés dans les extraits de code.
+Cet exemple configure le bac à sable d’API pour qu’il soit interactif, avec des extraits de code pour cURL, Python et JavaScript. Seuls les paramètres obligatoires sont affichés dans les extraits, et le bac à sable préremplit le corps de la requête avec des valeurs d’exemple.
 
 <div id="custom-endpoint-pages">
   ### Pages d’endpoint personnalisées
 </div>
 
 Lorsque vous avez besoin d’un contrôle plus fin sur votre documentation API, utilisez l’extension `x-mint` dans votre spécification OpenAPI ou créez des pages `MDX` individuelles pour vos endpoints.
 
 Ces deux options vous permettent de :
 
 * Personnaliser les metadata de la page
 * Ajouter du contenu supplémentaire, comme des exemples
 * Contrôler le comportement du playground par page
 
 Nous recommandons l’extension `x-mint` afin que l’ensemble de votre documentation API soit automatiquement généré à partir de votre spécification OpenAPI et maintenu dans un seul fichier.
 
 Les pages `MDX` individuelles sont recommandées pour les petites API ou lorsque vous souhaitez expérimenter des modifications page par page.
 
 Pour plus d’informations, voir [x-mint extension](/fr/api-playground/openapi-setup#x-mint-extension) et [MDX Setup](/fr/api-playground/mdx/configuration).
 
 <div id="further-reading">
   ## Pour aller plus loin
 </div>
 

fr/organize/settings.mdx

@@ -1,22 +1,22 @@
 ---
 title: "Paramètres globaux"
 description: "Configurez les paramètres à l’échelle du site avec le fichier `docs.json`"
 keywords: ["docs.json", "paramètres", "personnalisation", "configuration"]
 ---
 
 import IconsOptional from "/snippets/fr/icons-optional.mdx";
 
 Le fichier `docs.json` vous permet de transformer une collection de fichiers Markdown en un site de documentation personnalisable et facile à parcourir. Ce fichier de configuration requis contrôle le style, la navigation, les integrations, et bien plus encore. Considérez‑le comme le plan de votre documentation.
 
 Les paramètres de `docs.json` s’appliquent globalement à toutes les pages.
 
 <div id="setting-up-your-docsjson">
   ## Configuration de votre `docs.json`
 </div>
 
 Pour commencer, vous n’avez besoin de spécifier que `theme`, `name`, `colors.primary` et `navigation`. Les autres champs sont facultatifs et vous pourrez les ajouter à mesure que vos besoins en documentation évoluent.
 
 Pour une expérience d’édition optimale, incluez la référence de schéma en haut de votre fichier `docs.json`. Cela active l’autocomplétion, la validation et des info-bulles utiles dans la plupart des éditeurs de code :
 
 ```json
 {
@@ -29,7 +29,7 @@
   "navigation": {
     // Votre structure de navigation
   }
   // Le reste de votre configuration
 }
 ```
 
@@ -44,7 +44,7 @@
 </div>
 
 <ResponseField name="theme" required>
   Le thème de mise en page de votre site.
 
   L’un des suivants : `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`.
 
@@ -80,15 +80,15 @@
 </ResponseField>
 
 <ResponseField name="description" type="string">
   Description de votre site pour le SEO et l’indexation par l’IA.
 </ResponseField>
 
 <ResponseField name="logo" type="string or object">
   Votre logo pour les modes clair et sombre.
 
   <Expandable title="Logo">
     <ResponseField name="light" type="string" required>
       Chemin vers votre fichier de logo pour le mode clair. Incluez l’extension du fichier. Exemple : `/logo.png`
     </ResponseField>
 
     <ResponseField name="dark" type="string" required>
@@ -117,7 +117,7 @@
 </ResponseField>
 
 <ResponseField name="thumbnails" type="object">
   Personnalisation des vignettes pour les réseaux sociaux et les aperçus de page.
 
   <Expandable title="Thumbnails">
     <ResponseField name="appearance" type="&#x22;light&#x22; | &#x22;dark&#x22;">
@@ -196,7 +196,7 @@
 
   <Expandable title="Icons">
     <ResponseField name="library" type="&#x22;fontawesome&#x22; | &#x22;lucide&#x22;" required>
       Bibliothèque d’icônes à utiliser dans toute votre documentation. Par défaut : `fontawesome`.
 
       <Note>
         Vous pouvez spécifier une URL vers une icône hébergée en externe, un chemin vers un fichier d’icône dans votre projet, ou du code SVG compatible JSX pour n’importe quelle icône individuelle, quelle que soit la configuration de la bibliothèque.
@@ -206,11 +206,11 @@
 </ResponseField>
 
 <ResponseField name="fonts" type="object">
   Configuration des polices pour votre documentation. La police par défaut est [Inter](https://fonts.google.com/specimen/Inter).
 
   <Expandable title="Fonts">
     <ResponseField name="family" type="string" required>
       Famille de polices, par exemple « Open Sans ».
     </ResponseField>
 
     <ResponseField name="weight" type="number">
@@ -238,7 +238,7 @@
         </ResponseField>
 
         <ResponseField name="source" type="string (uri)">
           URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) est chargé automatiquement lorsque vous indiquez un nom de `family` Google Font, donc aucune URL source n’est nécessaire.
         </ResponseField>
 
         <ResponseField name="format" type="&#x22;woff&#x22; | &#x22;woff2&#x22;">
@@ -272,11 +272,11 @@
 </ResponseField>
 
 <ResponseField name="appearance" type="object">
   Paramètres du bouton de bascule mode clair/sombre.
 
   <Expandable title="Appearance">
     <ResponseField name="default" type="&#x22;system&#x22; | &#x22;light&#x22; | &#x22;dark&#x22;">
       Mode de thème par défaut. Choisissez `system` pour correspondre aux réglages du système d’exploitation des utilisateurs, ou `light` ou `dark` pour imposer un mode spécifique. Par défaut : `system`.
     </ResponseField>
 
     <ResponseField name="strict" type="boolean">
@@ -286,11 +286,11 @@
 </ResponseField>
 
 <ResponseField name="background" type="object">
   Paramètres de couleur et de décoration d’arrière-plan.
 
   <Expandable title="Background">
     <ResponseField name="image" type="string or object">
       Image d’arrière-plan de votre site. Peut être un fichier unique ou des fichiers distincts pour les modes light et sombre.
 
       <Expandable title="Image">
         <ResponseField name="light" type="string" required>
@@ -300,7 +300,7 @@
         <ResponseField name="dark" type="string" required>
           Chemin vers votre image d’arrière-plan pour le mode sombre. Incluez l’extension du fichier. Exemple : `/background-dark.png`.
         </ResponseField>
       </Expandable>
     </ResponseField>
 
     <ResponseField name="decoration" type="&#x22;gradient&#x22; | &#x22;grid&#x22; | &#x22;windows&#x22;">
@@ -332,11 +332,11 @@
 </div>
 
 <ResponseField name="navbar" type="object">
   Éléments de la barre de navigation pointant vers des liens externes.
 
   <Expandable title="Navbar">
     <ResponseField name="links" type="array of object">
       Liens à afficher dans la barre de navigation
 
       <Expandable title="Links">
         <ResponseField name="label" type="string" required>
@@ -372,11 +372,11 @@
 </ResponseField>
 
 <ResponseField name="navigation" type="object" required>
   La structure de navigation de votre contenu.
 
   <Expandable title="Navigation">
     <ResponseField name="global" type="object">
       Éléments de navigation globaux qui apparaissent sur toutes les pages et sections.
 
       <Expandable title="Global">
         <ResponseField name="langues" type="array of object">
@@ -542,21 +542,21 @@
 </ResponseField>
 
 <ResponseField name="interaction" type="object">
   Paramètres d’interaction utilisateur pour les éléments de navigation.
 
   <Expandable title="Interaction">
     <ResponseField name="drilldown" type="boolean">
       Contrôle le comportement de navigation automatique lors de la sélection des groupes de navigation. Définissez sur `true` pour forcer la navigation vers la première page lorsqu’un groupe de navigation est développé. Définissez sur `false` pour empêcher la navigation et uniquement développer ou réduire le groupe. Laissez la valeur non définie pour utiliser le comportement par défaut du thème.
     </ResponseField>
   </Expandable>
 </ResponseField>
 
 <ResponseField name="footer" type="object">
   Contenu du pied de page et liens vers les réseaux sociaux.
 
   <Expandable title="Footer">
     <ResponseField name="socials" type="object">
       Profils de réseaux sociaux à afficher dans le pied de page. Chaque key est un nom de plateforme et chaque value est l’URL de votre profil. Par exemple :
 
       ```json
       {
@@ -598,11 +598,11 @@
 </ResponseField>
 
 <ResponseField name="banner" type="object">
   Bannière de site affichée en haut des pages.
 
   <Expandable title="Banner">
     <ResponseField name="content" type="string">
       Contenu de la bannière. Prend en charge le texte brut et le formatage Markdown. Par exemple :
 
       ```json
       {
@@ -618,11 +618,11 @@
 </ResponseField>
 
 <ResponseField name="redirects" type="array of object">
   Redirections pour les pages déplacées, renommées ou supprimées.
 
   <Expandable title="Redirects">
     <ResponseField name="source" type="string" required>
       Chemin source à rediriger. Exemple : `/old-page`
     </ResponseField>
 
     <ResponseField name="destination" type="string" required>
@@ -636,11 +636,11 @@
 </ResponseField>
 
 <ResponseField name="contextual" type="object">
   Menu contextuel pour du contenu optimisé par l’IA et des intégrations.
 
   <Expandable title="Contextual">
     <ResponseField name="options" type="array of &#x22;copy&#x22; | &#x22;view&#x22; | &#x22;chatgpt&#x22; | &#x22;claude&#x22; | &#x22;perplexity&#x22; | &#x22;mcp&#x22; | &#x22;cursor&#x22; | &#x22;vscode&#x22;" required>
       Actions disponibles dans le menu contextuel. La première option apparaît par défaut.
 
       * `copy`: Copier la page actuelle en Markdown dans le presse-papiers.
       * `view`: Afficher la page actuelle en Markdown dans un nouvel onglet.
@@ -648,7 +648,7 @@
       * `claude`: Envoyer le contenu de la page actuelle à Claude.
       * `perplexity`: Envoyer le contenu de la page actuelle à Perplexity.
       * `mcp`: Copie l’URL de votre serveur MCP dans le presse-papiers.
       * `cursor`: Installe votre serveur MCP hébergé dans Cursor.
       * `vscode`: Installe votre serveur MCP hébergé dans VSCode.
 
       <img src="/images/page-context-menu.png" alt="Menu contextuel" className="rounded-xl" />
@@ -661,21 +661,21 @@
 </ResponseField>
 
 <div id="api-configurations">
-  ### Paramétrages d’API
+  ### Configuration d’API
 </div>
 
 <ResponseField name="api" type="object">
   Paramètres de la documentation d’API et du bac à sable interactif.
 
   <Expandable title="Api">
     <ResponseField name="openapi" type="string or array or object">
       Fichiers de spécification OpenAPI pour générer la documentation d’API. Peut être une seule URL/un seul chemin ou un tableau d’URL/chemins.
 
       <Expandable title="Openapi">
         <ResponseField name="source" type="string">
           URL ou chemin vers votre fichier de spécification OpenAPI.
 
-          Longueur minimale : 1
+          Longueur minimale : 1
         </ResponseField>
 
         <ResponseField name="directory" type="string">
@@ -693,7 +693,7 @@
         <ResponseField name="source" type="string">
           URL ou chemin vers votre fichier de spécification AsyncAPI.
 
-          Longueur minimale : 1
+          Longueur minimale : 1
         </ResponseField>
 
         <ResponseField name="directory" type="string">
@@ -709,7 +709,7 @@
 
       <Expandable title="Params">
         <ResponseField name="expanded" type="&#x22;all&#x22; | &#x22;closed&#x22;">
-          Indique s’il faut développer tous les paramètres par défaut. Par défaut : `closed`.
+          Indique s’il faut développer tous les paramètres par défaut. Valeur par défaut : `closed`.
         </ResponseField>
       </Expandable>
     </ResponseField>
@@ -719,31 +719,35 @@
 
       <Expandable title="Playground">
         <ResponseField name="display" type="&#x22;interactive&#x22; | &#x22;simple&#x22; | &#x22;none&#x22;">
-          Mode d’affichage du bac à sable d’API. Par défaut : `interactive`.
+          Mode d’affichage du bac à sable d’API. Valeur par défaut : `interactive`.
         </ResponseField>
 
         <ResponseField name="proxy" type="boolean">
-          Indique s’il faut faire transiter les requêtes d’API via un serveur proxy. Par défaut : `true`.
+          Indique si les requêtes d’API doivent passer par un serveur proxy. Valeur par défaut : `true`.
         </ResponseField>
       </Expandable>
     </ResponseField>
 
     <ResponseField name="examples" type="object">
-      Paramètres pour les exemples d’API générés automatiquement.
+      Configuration des exemples d’API générés automatiquement.
 
       <Expandable title="Examples">
         <ResponseField name="languages" type="array of string">
           Langages des extraits d’API générés automatiquement
         </ResponseField>
 
         <ResponseField name="defaults" type="&#x22;required&#x22; | &#x22;all&#x22;">
-          Indique s’il faut afficher les paramètres optionnels dans les exemples d’API. Par défaut : `all`.
+          Indique s’il faut afficher les paramètres optionnels dans les exemples d’API. Valeur par défaut : `all`.
+        </ResponseField>
+
+        <ResponseField name="prefill" type="boolean">
+          Indique s’il faut préremplir le bac à sable d’API avec des données issues des exemples de schéma. Lorsqu’elle est activée, l’interface remplit automatiquement les champs de requête avec des valeurs d’exemple tirées de votre spécification OpenAPI. Valeur par défaut : `false`.
         </ResponseField>
       </Expandable>
     </ResponseField>
 
     <ResponseField name="mdx" type="object">
-      Paramètres pour les pages d’API générées à partir de fichiers `MDX`.
+      Configuration des pages d’API générées à partir de fichiers `MDX`.
 
       <Expandable title="Mdx">
         <ResponseField name="auth" type="object">
@@ -755,7 +759,7 @@
             </ResponseField>
 
             <ResponseField name="name" type="string">
-              Nom d’authentification pour les requêtes d’API.
+              Nom de l’authentification pour les requêtes d’API.
             </ResponseField>
           </Expandable>
         </ResponseField>
@@ -769,7 +773,7 @@
 </ResponseField>
 
 <div id="seo-and-search">
   ### SEO et recherche
 </div>
 
 <ResponseField name="seo" type="object">
@@ -777,7 +781,7 @@
 
   <Expandable title="Seo">
     <ResponseField name="metatags" type="object">
       Balises meta ajoutées à chaque page. Doit être une paire key-value valide. Voir la [référence des balises meta courantes](/fr/optimize/seo#common-meta-tags-reference) pour les options.
     </ResponseField>
 
     <ResponseField name="indexing" type="&#x22;navigable&#x22; | &#x22;all&#x22;">
@@ -791,7 +795,7 @@
 
   <Expandable title="Search">
     <ResponseField name="prompt" type="string">
       Texte d’espace réservé affiché dans la barre de recherche.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -1025,15 +1029,15 @@
 </ResponseField>
 
 <div id="errors">
   ### Erreurs
 </div>
 
 <ResponseField name="errors" type="object">
   Paramètres de gestion des erreurs.
 
   <Expandable title="Erreurs">
     <ResponseField name="404" type="object">
       Gestion de l’erreur 404 « Page non trouvée ».
 
       <Expandable title="404">
         <ResponseField name="redirect" type="boolean">
@@ -1053,7 +1057,7 @@
 </ResponseField>
 
 <div id="examples">
   ## Exemples
 </div>
 
 <Tabs>
@@ -1573,14 +1577,14 @@
 </Tabs>
 
 <div id="upgrading-from-mintjson">
   ## Mise à niveau depuis `mint.json`
 </div>
 
 Si votre projet de documentation utilise le fichier `mint.json` obsolète, suivez ces étapes pour passer à `docs.json`.
 
 <Steps>
   <Step title="Installer ou mettre à jour l’interface en ligne de commande (CLI)">
     Si vous n’avez pas encore installé la [CLI](/fr/installation), installez-la maintenant :
 
     <CodeGroup>
       ```bash npm
@@ -1604,15 +1608,15 @@
   </Step>
 
   <Step title="Créer votre fichier docs.json">
     Dans votre référentiel de documentation, exécutez :
 
     ```bash
     mint upgrade
     ```
 
     Cette commande va créer un fichier `docs.json` à partir de votre `mint.json` existant. Passez en revue le fichier généré pour vous assurer que tous les paramètres sont corrects.
   </Step>
 
   <Step title="Supprimer votre fichier mint.json">
     Après avoir vérifié que votre `docs.json` est correctement configuré, vous pouvez supprimer en toute sécurité votre ancien fichier `mint.json`.
   </Step>

zh/api-playground/overview.mdx

@@ -74,7 +74,7 @@ API 操作台是一个交互式环境，便于用户测试并探索你的 API 
 </Steps>
 
 <div id="customizing-your-playground">
-  ## 自定义你的操作台
+  ## 自定义操作台
 </div>
 
 你可以在 `docs.json` 中通过定义以下属性来自定义 API 操作台。
@@ -100,18 +100,22 @@ API 操作台是一个交互式环境，便于用户测试并探索你的 API 
 </ResponseField>
 
 <ResponseField name="examples" type="object">
-  自动生成的 API 示例的相关配置。
+  自动生成的 API 示例配置。
 
   <Expandable title="examples" defaultOpen="True">
     <ResponseField name="languages" type="array of string">
-      自动生成的 API 代码片段所使用的示例语言。
+      自动生成的 API 代码片段的示例语言。
 
       语言按指定顺序显示。
     </ResponseField>
 
     <ResponseField name="defaults" type="&#x22;required&#x22; | &#x22;all&#x22;">
       是否在 API 示例中显示可选参数。默认为 `all`。
     </ResponseField>
+
+    <ResponseField name="prefill" type="boolean">
+      是否使用架构示例的数据预填充 API 操作台。启用后，操作台会自动使用你的 OpenAPI 规范中的示例值填充请求字段。默认为 `false`。
+    </ResponseField>
   </Expandable>
 </ResponseField>
 
@@ -127,13 +131,14 @@ API 操作台是一个交互式环境，便于用户测试并探索你的 API 
    },
    "examples": {
      "languages": ["curl", "python", "javascript"],
-     "defaults": "required"
+     "defaults": "required",
+     "prefill": true
    }
  }
 }
 ```
 
-此示例将 API 操作台配置为可交互，并提供 cURL、Python 和 JavaScript 的示例代码片段。代码片段中仅展示必填参数。
+此示例将 API 操作台配置为可交互，并提供 cURL、Python 和 JavaScript 的示例代码片段。代码片段仅显示必填参数，且操作台会用示例值预填请求正文。
 
 <div id="custom-endpoint-pages">
   ### 自定义端点页面