business-messaging-api_v23.0.yaml is not valid

Aperta Adatta ai principianti
#4 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
68/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
openapi
Ambito
api

Direzione di ricerca

Inizia con business-messaging-api_v23.0.yaml ed esamina la dichiarazione components.parameterGroups segnalata da entrambi i comandi di convalida. Riproduci i controlli di swagger-spec-validator e OpenAPI Generator, quindi conferma che la specifica superi la convalida e la generazione TypeScript Axios senza l'errore unexpected-attribute.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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)
Lingua principale
Nessun dato sulla lingua
Stelle
179
Fork
61
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di facebook/openapi

Tutte le issue di facebook/openapi

Issue simili

Altre issue su Backend & API Design

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.