Azure API Management
An Azure service that provides a hybrid, multi-cloud management platform for APIs.
2,447 questions
API Management - Swagger example not showing in Developer Portal, but working SwaggerUI
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(41.6, 60%, 14%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3EJH%3C/text%3E%3C/svg%3E)
johannes.hirschmann
6
Reputation points
Hi, I'm having trouble getting the API documentation in the Developer Portal to be displayed as desired.
I have a List of a Dictionary<string, DicomAttribute> for which I want to display the structure and an example. I have attached the Open API Json file (a simplified version, but should be good enough for demonstration purposes) in the .txt. file. 171925-openapi-json.txt
Using SwaggerUI or swagger editor https://editor.swagger.io/ the structure and example is displayed fine:
But when getting this to the API Management the example does not show up in the Dev Portal:
And also the referenced definition of DicomAttribute is not displayed in the "Definitions" section.
Do you have any idea what could go wrong here?
The imported definitions in API Management look fine..
Thanks in adavance!
Johannes
Azure API Management
{count} vote
-
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(294.40000000000003, 87%, 38%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3EM%3C/text%3E%3C/svg%3E)
MikeUrnun 9,777 Reputation points Moderator2022-02-09T20:06:54.257+00:00 Hello @johannes.hirschmann - I'll look thoroughly into this & share my findings but did you re-publish your Developer Portal and make sure it's reading from the latest version of your API specs?
-
johannes.hirschmann 6 Reputation points
2022-02-09T20:11:14.257+00:00 Hi @MikeUrnun , thank you! Yes, we deployed the latest version of our API specs. I also made sure by checking the API Management Azure resource itself.
-
MikeUrnun 9,777 Reputation points Moderator
2022-02-09T20:38:50.767+00:00 @johannes.hirschmann Yup, please really make sure that you are re-publishing your Dev Portal component whenever you push new updates to your APIs (I believe the team is working on automating it). If you're good there, it could also be a bug, similar to the ones reported here: https://github.com/Azure/api-management-developer-portal/issues?q=is%3Aissue+label%3A%22%28t%29+Bug%22+developer+portal+display I'll investigate :)
Sign in to comment
Sign in to answer