Add Xquik OpenAPI example#2
Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 0bd35c274e
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| - 文件大小限制:10MB | ||
| - 拖拽文件或点击上传区域选择文件 | ||
|
|
||
| 可使用 Xquik 的公开 OpenAPI 3.1 JSON 作为远程规范示例: |
There was a problem hiding this comment.
Do not recommend a 3.1 spec for validation
This example is presented as a fixture for verifying conversion and auth metadata, but the app exposes the strict 验证规范 option immediately below; when users enable it, the current Higress converter's validator still treats OpenAPI 3.1-only schema keywords used by Xquik (for example const) as invalid extra fields, so the documented sample fails instead of demonstrating a successful upload. Either use a 3.0 sample here or explicitly tell users to leave strict validation off until the converter supports 3.1.
Useful? React with 👍 / 👎.
Summary
Validation
git diff --checknode --check src/server.jshttps://xquik.com/openapi.jsonwithjqfor OpenAPI 3.1, title, server URL, andx-api-keymetadata.