Documentació i client web de l'API Swagger
Traducció de l’original en anglès. Llegeix-lo en: CastellanoEnglish
Per exemple, fem servir NPM (Nginx Proxy Manager). La interfície web d'usuari (WUI) de NPM es recolza en una API de backend. Si inspecciones les peticions de xarxa del navegador, pots observar com funciona.
Tot i això, no vaig aconseguir trobar documentació completa d'aquesta API. Amb una mica de recerca, pots descobrir que l'API de NPM exposa el seu esquema en un lloc concret:
https://npm.your-domain.tld/api/schema
Si busques un client d'API còmode basat en web, juntament amb una interfície documentada que t'ajudi a entendre com fer-lo servir, només cal que executis el contenidor Docker següent:
docker run -p 80:8080 -d swaggerapi/swagger-ui
Obre el navegador i ves a http://localhost, i veuràs una cosa com aquesta:
Finalment, substitueix l'URL de l'API Petstore per la teva, com ara https://npm.your-domain.tld/api/schema, o per qualsevol URL d'OpenAPI que vulguis utilitzar.
A continuació tens una captura de pantalla de la meva configuració local de NPM:
Espero que aquest article t'hagi estat útil. Gràcies per dedicar el teu temps a llegir-lo.

