Swagger UI for admin api #172

Closed
opened 2025-12-29 14:24:23 +01:00 by adam · 2 comments
Owner

Originally created by @pmiossec on GitHub (Apr 11, 2019).

To make the use of the admin api easier, it could be interesting to add swagger UI.

See https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger?view=aspnetcore-2.2 and https://swagger.io/tools/swagger-ui/

Originally created by @pmiossec on GitHub (Apr 11, 2019). To make the use of the admin api easier, it could be interesting to add swagger UI. See https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger?view=aspnetcore-2.2 and https://swagger.io/tools/swagger-ui/
adam added the question label 2025-12-29 14:24:23 +01:00
adam closed this issue 2025-12-29 14:24:23 +01:00
Author
Owner

@StefH commented on GitHub (Apr 11, 2019):

I know. But adding automatically generated swagger to this wep-api is not possible because also the admin interface is dynamically defined.

Some time ago I did start a Swagger Doc here:
https://app.swaggerhub.com/apis/StefHeyenrath/WireMock/1.0.13.0

However, I think not all data is here yet.
So feel free to update ;-)

(And I will also take a look if I can add some more commands ....)

@StefH commented on GitHub (Apr 11, 2019): I know. But adding automatically generated swagger to this wep-api is not possible because also the admin interface is dynamically defined. Some time ago I did start a Swagger Doc here: https://app.swaggerhub.com/apis/StefHeyenrath/WireMock/1.0.13.0 However, I think not all data is here yet. So feel free to update ;-) (And I will also take a look if I can add some more commands ....)
Author
Owner

@pmiossec commented on GitHub (Apr 11, 2019):

But adding automatically generated swagger to this wep-api is not possible because also the admin interface is dynamically defined.

Ok, that was the reason.... I understand better now.

I just didn't know if you knew it (even if I found it surprising) and that's just after I created the issue that I saw the swaggerhub link). And I didn't found an issue talking about it. So I hope this issue will serve as a doc.

Swaggerhub is better than nothing but I find it clearly less usable than the embedded swagger UI (I didn't found how to specify the host when you run wiremock on other port than 80).

So feel free to update ;-)

I will be pleased to do it if I see something missing and if I will use wiremock more than just what I do for now. But don't expect a lot ;) We will see.

Thanks a lot for your clear answer.

@pmiossec commented on GitHub (Apr 11, 2019): >But adding automatically generated swagger to this wep-api is not possible because also the admin interface is dynamically defined. Ok, that was the reason.... I understand better now. I just didn't know if you knew it (even if I found it surprising) and that's just after I created the issue that I saw the swaggerhub link). And I didn't found an issue talking about it. So I hope this issue will serve as a doc. Swaggerhub is better than nothing but I find it clearly less usable than the embedded swagger UI (I didn't found how to specify the host when you run wiremock on other port than 80). >So feel free to update ;-) I will be pleased to do it if I see something missing and if I will use wiremock more than just what I do for now. But don't expect a lot ;) We will see. Thanks a lot for your clear answer.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/WireMock.Net-wiremock#172