我如何描述OpenAPI 3中响应体中发送的JWT?

我如何描述OpenAPI 3中响应体中发送的JWT?,jwt,swagger,openapi,Jwt,Swagger,Openapi,根据jwt.io上的 输出是三个由点分隔的Base64 URL字符串,可以在HTML和HTTP环境中轻松传递。” 我试图找出如何在响应的模式中描述这一点。我被绊倒了,因为在我看来,“由点分隔的三个字符串”本身就是一个字符串——对吗 内容部分是这样的吗 content: text/plain: schema: type: string ,我在components/securitySchemes部分看到了如何描述承载身份验证,但我认为这与全局/路径操作安全部分有关,而不是与

根据jwt.io上的

输出是三个由点分隔的Base64 URL字符串,可以在HTML和HTTP环境中轻松传递。”

我试图找出如何在响应的模式中描述这一点。我被绊倒了,因为在我看来,“由点分隔的三个字符串”本身就是一个字符串——对吗

内容部分是这样的吗

content:
  text/plain:
    schema:
      type: string

,我在components/securitySchemes部分看到了如何描述承载身份验证,但我认为这与全局/路径操作安全部分有关,而不是与服务器向客户端发送JWT时的登录方法有关。

您可以使用
text/plain
并添加描述,也可以使用
应用程序/JWT
。或两者兼有:-)


您可以使用
text/plain
并添加说明,也可以使用
应用程序/jwt
。或者两者兼用:-)

responses:
    '200':
      description: a JSON web token (JWT) required to login.
      content:
        application/jwt:
          schema:
            type: string