Newbie question about Mapping Swagger Documentation
I'm new to Swagger APIs and JSON APIs in general. Mostly doing practical business Python. Now I have a Swagger API from which I need to get some data. The project has Swagger Documentation. I can add the API key for my client and get the Resources, but the Representations are not quite what I expected, knowing the material. I feel like there's another layer that I'm not seeing--possibly in the Platform's setup of the client's Application. I found this post,Visualising complex APIs using API MapFollowing in this direction, was able to use the Pikturr script to generate a UML from the Platform's Swagger API. However, this obviously doesn't include the my client's content. Any suggestions how I can map the Swagger API Documentation using my client's API Key? Or, Am I misunderstanding something about Swagger APIs asking this question? I've found several other packages on Github which do similar things, swagger_to_uml, Swagger2Puml, and a tutorial From Swagger to Confluence UML diagrams; however, none describe this particular problem.
Issue with creating a documentation when using re-usable enums
My yaml file looks like this openapi: 3.0.2 components: schemas: Countries: type: string enum: - Unknown - Afghanistan - Albania - Algeria - AmericanSamoa - "\u00c5landIslands" - NotOtherwiseSpecified , when I compile it it creates the java classes correctly, however is not creating the documentation, just gives me: GeopoliticalAffiliation - and nothing more is displayed for that praticular scheme. For the other schemes enum options are displayed, etc. Can you help me with this problem? Is this an issue of swagger or I am mistaken somehwere.The example in the swagger website and my code are following the same rules:https://swagger.io/docs/specification/data-models/enums/. P.S. I tought the problem is comming because of the special caracter, but is not. I tried without that specific enum entry and also I have another similar way reusable enum that behaves the same way.
