swagger-api / swagger-api/swagger-codegen

Error with the exported NodeJS-server version

Open
#8,293 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Mustache
Stars
17.8k
Forks
6k
PR merge metrics
No merged PRs in 30d

Description

Description

Hello!

I've been facing an issue with the exported version of my API. I export it to nodejs-server and I run on another server so my business partners can check the documentation.

The problem that i'm facing occurs with array objects that are not showing their nested properties. This behavior only occurs in the exported version. While I'm edting it on swaggerhub or swagger editor it properly appears, as shown below:

image

On my API documentation website it is shown like this:

image

It was working sometime ago, i've been trying to fix it but wasn't successful. I don't know if something changed that I need to change my code or there's a bug out there.

Swagger-codegen version

I'm using SwaggerHub OAS 2.0, I'm kinda new in this area, don't if that answers this topic (:

Swagger declaration file content or url

GIST - My definition simplified

I appreciate any help that I can get. Thanks in advance!

Command line used for generation
Steps to reproduce
Related issues/PRs
Suggest a fix/enhancement

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the simplified Swagger definition in the linked Gist and reproduce the nodejs-server export, comparing its rendered array objects with the SwaggerHub or Swagger Editor view. Trace the generated documentation output and confirm that nested properties in array objects are displayed consistently in the exported version.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js, openapi
Domain
api, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.