You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Si el cuadro de texto que aparece abajo tiene un borde verde, tu documento ha pasado la validación.
23
-
Este es exactamente el mismo paquete de validación que usa Mintlify para validar documentos de OpenAPI, así que si tu documento
24
-
pasa la validación aquí, es muy probable que el problema esté en otra parte.
22
+
Si el cuadro de texto que aparece abajo tiene un borde verde, tu documento ha superado la validación.
23
+
Este es exactamente el mismo paquete de validación que utiliza Mintlify para validar documentos de OpenAPI, así que si tu documento
24
+
pasa la validación aquí, hay muchas probabilidades de que el problema esté en otra parte.
25
25
26
26
Además, Mintlify no es compatible con OpenAPI 2.0. Si tu documento usa esta versión de la especificación,
27
27
podrías encontrarte con este problema. Puedes convertir tu documento en [editor.swagger.io](https://editor.swagger.io/) (en Edit > Convert to OpenAPI 3):
28
28
29
29
<Frame>
30
-
30
+
31
31
</Frame>
32
32
</Accordion>
33
33
34
-
<Accordiontitle="Una de mis páginas de OpenAPI aparece completamente en blanco">
35
-
Esto suele deberse a un campo `openapi` mal escrito en la metadata de la página. Asegúrate de que el método HTTP y la ruta coincidan exactamente con el método HTTP y la ruta del documento de OpenAPI.
34
+
<Accordiontitle="Una de mis páginas de OpenAPI está completamente en blanco">
35
+
Esto suele deberse a un campo `openapi` mal escrito en la metadata de la página. Asegúrate de que
36
+
el método HTTP y la ruta coincidan exactamente con el método HTTP y la ruta del documento de OpenAPI.
36
37
37
38
Aquí tienes un ejemplo de cómo puede salir mal:
38
39
@@ -50,7 +51,7 @@ Si tus páginas de API no se muestran correctamente, revisa estos problemas de c
50
51
51
52
Observa que la ruta en el campo `openapi` tiene una barra al final, mientras que la ruta en el documento de OpenAPI no la tiene.
52
53
53
-
Otro problema común es un nombre de archivo mal escrito. Si especificas un documento de OpenAPI en particular en el campo `openapi`, asegúrate de que el nombre del archivo sea correcto. Por ejemplo, si tienes dos documentos de OpenAPI, `openapi/v1.json` y `openapi/v2.json`, tu metadata podría verse así:
54
+
Otro problema común es un nombre de archivo mal escrito. Si especificas un documento de OpenAPI en particular en el campo `openapi`, asegúrate de que el nombre del archivo sea correcto. Por ejemplo, si tienes dos documentos de OpenAPI `openapi/v1.json` y `openapi/v2.json`, tu metadata podría verse así:
54
55
55
56
```mdx api-reference/v1/users/get-user.mdx
56
57
---
@@ -60,15 +61,15 @@ Si tus páginas de API no se muestran correctamente, revisa estos problemas de c
60
61
</Accordion>
61
62
62
63
<Accordion title="Las solicitudes desde el área de pruebas de la API no funcionan">
63
-
Si tienes un domain personalizado configurado, esto podría deberse a tu proxy inverso. De forma predeterminada, las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la ruta `/_mintlify/api/request` en el sitio de documentación. Si tu proxy inverso está configurado para permitir únicamente solicitudes `GET`, todas estas solicitudes fallarán. Para solucionarlo, configura tu proxy inverso para permitir solicitudes `POST` a la ruta `/_mintlify/api/request`.
64
+
Si tienes un domain personalizado configurado, esto podría deberse a un problema con tu proxy inverso. De forma predeterminada, las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la ruta `/_mintlify/api/request` en el sitio de documentación. Si tu proxy inverso está configurado para permitir únicamente solicitudes `GET`, entonces todas estas solicitudes fallarán. Para solucionarlo, configura tu proxy inverso para permitir solicitudes `POST` a la ruta `/_mintlify/api/request`.
64
65
65
-
Como alternativa, si tu proxy inverso impide aceptar solicitudes `POST`, puedes configurar Mintlify para enviar solicitudes directamente a tu backend con la opción `api.playground.proxy` en `docs.json`, como se describe en la [documentación de configuración](/es/organize/settings#param-proxy). Al usar esta configuración, deberás configurar CORS en tu servidor, ya que las solicitudes vendrán directamente desde los navegadores de los usuarios en lugar de pasar por tu proxy.
66
+
Como alternativa, si tu proxy inverso impide aceptar solicitudes `POST`, puedes configurar Mintlify para enviar solicitudes directamente a tu backend con el ajuste `api.playground.proxy` en el `docs.json`, como se describe en la [documentación de configuración](/es/organize/settings#param-proxy). Al usar esta configuración, deberás configurar CORS en tu servidor, ya que las solicitudes llegarán directamente desde los navegadores de los usuarios en lugar de pasar por tu proxy.
66
67
</Accordion>
67
68
68
69
<Accordion title="Las entradas de navigation de OpenAPI no están generando páginas">
69
-
Si estás usando una configuración de navigation de OpenAPI, pero las páginas no se generan, revisa estos problemas comunes:
70
+
Si usas una configuración de navigation de OpenAPI, pero las páginas no se generan, revisa estos problemas comunes:
70
71
71
-
1. **Falta la especificación predeterminada de OpenAPI**: Asegúrate de tener definido un campo `openapi` para el elemento de navigation:
72
+
1. **Falta la especificación de OpenAPI predeterminada**: Asegúrate de tener definido un campo `openapi` en el elemento de navigation:
72
73
73
74
```json {5}
74
75
"navigation": {
@@ -85,22 +86,22 @@ Si tus páginas de API no se muestran correctamente, revisa estos problemas de c
85
86
}
86
87
```
87
88
88
-
2. **Herencia de la especificación OpenAPI**: Si usas navegación anidada, asegúrate de que los grupos hijos hereden la especificación OpenAPI correcta o definan la suya propia.
89
+
2. **Herencia de la especificación OpenAPI**: Si usas navigation anidada, asegúrate de que los grupos hijos hereden la especificación OpenAPI correcta o definan la suya propia.
89
90
90
91
3. **Problemas de validación**: Usa `mint openapi-check <path-to-openapi-file>` para verificar que tu documento OpenAPI sea válido.
91
92
</Accordion>
92
93
93
94
<Accordion title="Algunas operaciones de OpenAPI aparecen en navigation, pero otras no">
94
95
1. **Operaciones ocultas**: Las operaciones marcadas con `x-hidden: true` en tu especificación de OpenAPI no aparecerán en la navigation generada automáticamente.
95
96
2. **Operaciones no válidas**: Las operaciones con errores de validación en la especificación de OpenAPI pueden omitirse. Revisa tu documento de OpenAPI para detectar errores de sintaxis.
96
-
3. **Inclusión manual vs. automática**: Si haces referencia a endpoints desde una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecerán en la navigation. No se añadirá ninguna otra página automáticamente. Esto incluye las operaciones referenciadas en elementos secundarios de la navigation.
97
+
3. **Inclusión manual vs. automática**: Si haces referencia a endpoints de una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecerán en la navigation. No se agregarán otras páginas automáticamente. Esto incluye operaciones referenciadas en elementos secundarios de la navigation.
97
98
</Accordion>
98
99
99
100
<Accordion title="La navigation mixta (páginas de OpenAPI y MDX) no funciona correctamente">
100
-
Al combinar operaciones de OpenAPI con páginas de documentación regulares en navigation:
101
+
Al combinar operaciones de OpenAPI con páginas de documentación estándar en navigation:
101
102
102
103
1. **Conflictos de archivos**: No puedes tener a la vez un archivo `MDX` y una entrada en navigation para la misma operación. Por ejemplo, si tienes `get-users.mdx`, no incluyas también "GET /users" en tu navigation. Si necesitas un archivo que comparta nombre con una operación, usa la extensión `x-mint` del endpoint para que el href apunte a otra ubicación.
103
-
2. **Resolución de rutas**: Las entradas de navigation que no coincidan con operaciones de OpenAPI se tratarán como rutas de archivos. Asegúrate de que tus archivos `MDX` existan en las ubicaciones previstas.
104
+
2. **Resolución de rutas**: Las entradas en navigation que no coincidan con operaciones de OpenAPI se tratarán como rutas de archivo. Asegúrate de que tus archivos `MDX` existan en las ubicaciones esperadas.
104
105
3. **Distinción entre mayúsculas y minúsculas**: La coincidencia de operaciones de OpenAPI distingue mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation.
<imgclassName="block"src="https://mintlify-assets.b-cdn.net/hero-light.png"alt="Captura de la página de introducción de PearsDB como ejemplo de una imagen en un componente Update." />
15
15
</Frame>
16
16
17
17
### Novedades
18
18
19
-
* Diseño adaptable
19
+
* Diseño responsivo
20
20
* Ancla para cada actualización
21
-
* Entrada de RSS generada para cada actualización
21
+
* Entrada del feed RSS generada para cada actualización
Copy file name to clipboardExpand all lines: es/dashboard/sso.mdx
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -63,13 +63,13 @@ Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Ok
63
63
<Steptitle="Crear una aplicación">
64
64
En `Web and mobile apps`, selecciona `Add custom SAML app` en el menú desplegable `Add app`.
65
65
<Frame>
66
-
66
+
67
67
</Frame>
68
68
</Step>
69
69
<Steptitle="Envíanos la información de tu IdP">
70
70
Copia la SSO URL, el Entity ID y el certificado x509 proporcionados y envíalos al equipo de Mintlify.
71
71
<Frame>
72
-
72
+
73
73
</Frame>
74
74
</Step>
75
75
<Steptitle="Configurar la integración">
@@ -80,16 +80,16 @@ Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Ok
80
80
* Name ID: `Basic Information > Primary email`
81
81
82
82
<Frame>
83
-
83
+
84
84
</Frame>
85
85
86
-
En la siguiente página, introduce las siguientes declaraciones de atributos:
86
+
En la página siguiente, introduce las siguientes declaraciones de atributos:
87
87
| Google Directory Attribute | App Attribute |
88
88
| -------------------------- | ------------- |
89
89
| `First name` | `firstName` |
90
90
| `Last name` | `lastName` |
91
91
92
-
Una vez completado este paso y asignados los usuarios a la aplicación, avísanos y habilitaremos el SSO en tu cuenta.
92
+
Cuando completes este paso y los usuarios estén asignados a la aplicación, avísanos y habilitaremos el SSO para tu cuenta.
<imgsrc="/images/gitlab/gitlab-show-webtoken.png"alt="Captura de pantalla de la conexión de GitLab en el Dashboard de Mintlify. El botón Show Webtoken está resaltado."/>
77
77
</Frame>
78
78
</Step>
79
-
<Steptitle="Selecciona eventos">
79
+
<Steptitle="Selecciona los eventos">
80
80
Selecciona estos eventos para activar el webhook:
81
81
- **Push events** (All branches)
82
82
- **Merge requests events**
83
83
84
84
Cuando termines, debería verse así:
85
85
<Frame>
86
-
<imgsrc="/images/gitlab/gitlab-project-webtoken.png"alt="La página de Webhook en el dashboard de GitLab. Se resaltan los ajustes que hay que configurar para Mintlify." />
86
+
<imgsrc="/images/gitlab/gitlab-project-webtoken.png"alt="La página de Webhook en el dashboard de GitLab. Los ajustes para configurar Mintlify están resaltados." />
87
87
</Frame>
88
88
</Step>
89
89
<Steptitle="Prueba el webhook">
90
-
Después de crear el webhook, haz clic en el menú desplegable "Test" y selecciona "Push events" para enviar un payload de muestra y asegurarte de que esté configurado correctamente. Verás "Hook executed successfully: HTTP 200" si todo está configurado correctamente.
90
+
Después de crear el webhook, haz clic en el menú desplegable "Test" y selecciona "Push events" para enviar una carga de ejemplo y asegurarte de que esté configurado correctamente. Verás el mensaje "Hook executed successfully: HTTP 200" si todo está bien.
91
91
92
-
Esto te ayudará a verificar que todo funciona correctamente y que tu documentación se sincroniza adecuadamente con tu repositorio de GitLab.
92
+
Esto te ayudará a verificar que todo funcione correctamente y que tu documentación se sincronice correctamente con tu repositorio de GitLab.
<imgsrc="/images/gitlab/gitlab-project-webtoken-test.png"alt="Captura de pantalla de la página de Webhooks de GitLab. El elemento de menú 'Push events' está resaltado en el menú 'Test'."/>
![locadex-agent[bot]](https://avatars.githubusercontent.com/in/1436158?v=4&size=40){kind=avatar}
0 commit comments