openapi、api 和 asyncapi frontmatter 字段都必须是单一字符串。如果任何页面将这些字段之一设置为列表、数字或其他非字符串值,Mintlify 会使部署失败,并显示以下消息:
Invalid "<field>" frontmatter at path 开头。它会列出页面路径以及 Mintlify 收到的值类型,例如 received an array。
常见原因
- 在一个字段中列出多个端点,例如
openapi: [GET /users, POST /users]。 - 将值写成 YAML 列表,分布在以
-开头的多行中。 - 使用了被 YAML 解析为数字或布尔值而非字符串的值。
修复 frontmatter
Incorrect
Correct
openapi frontmatter 的完整格式,请参阅编写端点文档。