Corregir errores de despliegue "frontmatter must be a single endpoint string"

Cada página de endpoint MDX en Mintlify documenta exactamente un endpoint. Los campos de frontmatter openapi, api y asyncapi deben ser cada uno una sola cadena. Si alguna página configura uno de estos campos como una lista, un número u otro valor que no sea una cadena, Mintlify hace fallar el despliegue con este mensaje:

Page api, openapi, or asyncapi frontmatter must be a single endpoint string. Deployment not updated

Mintlify no publica ningún cambio de un despliegue fallido. Tu sitio en producción sigue sirviendo el último despliegue correcto hasta que corrijas la página. El error de la página individual comienza con Invalid "<field>" frontmatter at path. Indica la ruta de la página y el tipo de valor que recibió Mintlify, como received an array.

Causas comunes

Enumerar varios endpoints en un solo campo, como openapi: [GET /users, POST /users].
Escribir el valor como una lista YAML en líneas separadas que comienzan con -.
Usar un valor que YAML interpreta como un número o un booleano en lugar de una cadena.

Corregir el frontmatter

Configura el campo con una sola cadena de endpoint. Encierra el valor entre comillas para que YAML siempre lo interprete como una cadena.

Incorrect

---
title: "Users"
openapi: [GET /users, POST /users]
---

Correct

---
title: "List users"
openapi: "GET /users"
---

Para documentar más de un endpoint, crea una página independiente para cada endpoint. También puedes dejar que Mintlify genere una página por operación a partir de tu especificación. Consulta Generar automáticamente páginas de API. Para ver el formato completo del frontmatter openapi, consulta Documentar endpoints.

Temas relacionados

Configuración de OpenAPI Despliega en una subruta con Cloudflare Workers Solución de problemas

⌘I

​Causas comunes

​Corregir el frontmatter

Causas comunes

Corregir el frontmatter