How to fix the "duplicate mapping key" error in the SwaggerHub editor?
When I paste my OpenAPI definition into the SwaggerHub editor, it shows the "duplicate mapping key" error. If I add some spaces, then an indentation error is shown. How to fix these errors?
Here is my OpenAPI YAML code:
paths:
/widgets/home-page:
get:
tags:
- home Page APIs sfssf
description: asd
operationId: getwidgets
responses:
'200':
description: home page catregories widgets
content:
application/json:
schema:
type: array
items:
type: string
format: https://api.inspireuplift.com/api/v1/widgets/home-page
Solution
There are indentation errors and structural errors in your OpenAPI YAML. Specifically, there should be just one paths section at the root level, with individual paths listed inside it, like so:
paths: # <-----
/widgets/home-page: # <-----
get: # <-----
tags:
- home Page APIs sfssf
description: asd
operationId: getwidgets
responses:
'200':
...
/trending-products: # <-----
get: # <-----
tags: # <-----
- ...
description: ...
...
Pay attention to the structure and indentation in this example and fix your definition accordingly.
See the Paths and Operations guide on swagger.io for more details.
- Should Internal Server Error be documented in swagger?
- OpenAPI Generator doesn't generate functions for multipart/form-data
- How to style Swagger API docs with custom CSS in Node.js?
- Deploying an OpenAPI-based API gateway via Terraform?
- Openapi generator does not generate @XmlAttribute/@XmlElement annotations
- How to deprecate an entire API in OpenAPI?
- Only displays one endpoint when multiple endpoints of the same type are present with different Accept header values
- Generate offline docs for Swagger
- OpenAPI, SpringBoot 3.x not everything uses Jakarta instead of Javax
- How do I include subclasses in Swagger API documentation/ OpenAPI specification using Swashbuckle?
- OpenAPI custom generator with Maven plugin fails with ClassNotFoundException
- "Authorize" button not showing in Swagger UI (.NET 9)
- How to handle SecurityErrors as convenient errors with ogen
- Where to generate OpenAPI types in a Spring Modulith application?
- What is the correct way to declare a date in an OpenAPI / Swagger-file?
- How to set type mappings for OpenAPI generator in build.gradle file?
- Springdoc with Boot 3, no explicit OpenAPI bean declaration
- GCP API Gateway: Cannot use path params
- NoClassDefFoundError with Open API with Spring Boot 3
- Openapi - duplicate operationID and extra parameter
- Vert.x OpenAPI v4.5.10 ValidatorException: "The related request does not contain the required body" for POST request
- How to hide/exclude certain properties of schema for response in yaml file?
- Security is not added to Swagger from Open API generator
- Use OpenAPI 3.1 Schema to validate an OpenAPI spec
- How to correctly declare a route with facultative authentication in OpenAPI 3.0 specification?
- How to control the generated filename when generating OpenAPI specification at build time from the code in ASP.NET Core
- How to put Microprofile / OpenAPI annotations into interface for generating Swagger-file while keeping source-code clean
- How to define enum mapping in OpenAPI?
- Change Order of Tags using Swagger in C#
- How to exclude specific endpoint from API generation