business-messaging-api_v23.0.yaml is not valid
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 68/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Quiet
- Tech stack
- openapi
- Domain
- api
Research direction
Start with business-messaging-api_v23.0.yaml and inspect the components.parameterGroups declaration reported by both validation commands. Reproduce the swagger-spec-validator and OpenAPI Generator checks, then confirm the specification passes validation and TypeScript Axios generation without the unexpected-attribute error.
Written by the indexing model from the issue text.
Description
The OpenAPI spec seems to not be fully valid. When we try and validate the Swagger Doc using the following command, we see it returning business-messaging-api_v23.0.yaml: attribute components.parameterGroups is unexpected
docker run --rm node:26-alpine sh -c "apk add wget && npm i -g swagger-spec-validator && wget https://raw.githubusercontent.com/facebook/openapi/main/business-messaging-api_v23.0.yaml && swagger-spec-validator business-messaging-api_v23.0.yaml"
When we try and to a TS codegen from it, it also fails
docker run --rm node:26-alpine sh -c "apk add --no-cache openjdk17-jdk && npm install -g openapi-typescript @openapitools/openapi-generator-cli && npx @openapitools/openapi-generator-cli generate -i https://raw.githubusercontent.com/facebook/openapi/main/business-messaging-api_v23.0.yaml -g typescript-axios -o /tmp/"
returns
Exception in thread "main" org.openapitools.codegen.SpecValidationException: There were issues with the specification. The option can be disabled via validateSpec (Maven/Gradle) or --skip-validate-spec (CLI).
| Error count: 1, Warning count: 105
Errors:
-attribute components.parameterGroups is unexpected
Warnings:
-attribute components.parameterGroups is unexpected
at org.openapitools.codegen.config.CodegenConfigurator.toContext(CodegenConfigurator.java:718)
at org.openapitools.codegen.config.CodegenConfigurator.toClientOptInput(CodegenConfigurator.java:745)
at org.openapitools.codegen.cmd.Generate.execute(Generate.java:527)
at org.openapitools.codegen.cmd.OpenApiGeneratorCommand.run(OpenApiGeneratorCommand.java:32)
at org.openapitools.codegen.OpenAPIGenerator.main(OpenAPIGenerator.java:66)
- Dominant language
- No language data
- Stars
- 179
- Forks
- 61
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from facebook/openapi
-
v25.0 Open
Difficulty 4/5 3-5 days Newbie friendliness 42/100
-
Difficulty 5/5 Over a week Newbie friendliness 30/100
All issues in facebook/openapi
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
external-issue to-triage
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
googleapis/google-cloud-swift#1151 ·
-
external
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
langchain-ai/langgraph#9074 · 1 comment ·
-
documentation specification
Difficulty 1/5 Under an hour Newbie friendliness 90/100
openai/openai-openapi#584 ·