home.social

#swaggerui — Public Fediverse posts

Live and recent posts from across the Fediverse tagged #swaggerui, aggregated by home.social.

  1. Один Swagger вместо сотни страниц Confluence: как в Рунити навели порядок в API-документации

    Привет, Хабр! На связи Маргарита Сорочинская, технический писатель отдела архитектуры в Рунити. Хочу рассказать, как мы в компании подошли к описанию API в Swagger — и почему решили перенести туда всё, что раньше жило в Confluence. А еще поделюсь с вами стартерпаком для описания API в Swagger, пошаговой инструкцией и всеми ссылками, чтобы для вас этот путь был уже более простым :) Навигация по тексту:

    habr.com/ru/companies/runity/a

    #api #swagger #swaggerui #swaggertypescriptapi #confluence #git #gitlab #методы #документация #документирование_проектов

  2. Один Swagger вместо сотни страниц Confluence: как в Рунити навели порядок в API-документации

    Привет, Хабр! На связи Маргарита Сорочинская, технический писатель отдела архитектуры в Рунити. Хочу рассказать, как мы в компании подошли к описанию API в Swagger — и почему решили перенести туда всё, что раньше жило в Confluence. А еще поделюсь с вами стартерпаком для описания API в Swagger, пошаговой инструкцией и всеми ссылками, чтобы для вас этот путь был уже более простым :) Навигация по тексту:

    habr.com/ru/companies/runity/a

    #api #swagger #swaggerui #swaggertypescriptapi #confluence #git #gitlab #методы #документация #документирование_проектов

  3. Один Swagger вместо сотни страниц Confluence: как в Рунити навели порядок в API-документации

    Привет, Хабр! На связи Маргарита Сорочинская, технический писатель отдела архитектуры в Рунити. Хочу рассказать, как мы в компании подошли к описанию API в Swagger — и почему решили перенести туда всё, что раньше жило в Confluence. А еще поделюсь с вами стартерпаком для описания API в Swagger, пошаговой инструкцией и всеми ссылками, чтобы для вас этот путь был уже более простым :) Навигация по тексту:

    habr.com/ru/companies/runity/a

    #api #swagger #swaggerui #swaggertypescriptapi #confluence #git #gitlab #методы #документация #документирование_проектов

  4. Один Swagger вместо сотни страниц Confluence: как в Рунити навели порядок в API-документации

    Привет, Хабр! На связи Маргарита Сорочинская, технический писатель отдела архитектуры в Рунити. Хочу рассказать, как мы в компании подошли к описанию API в Swagger — и почему решили перенести туда всё, что раньше жило в Confluence. А еще поделюсь с вами стартерпаком для описания API в Swagger, пошаговой инструкцией и всеми ссылками, чтобы для вас этот путь был уже более простым :) Навигация по тексту:

    habr.com/ru/companies/runity/a

    #api #swagger #swaggerui #swaggertypescriptapi #confluence #git #gitlab #методы #документация #документирование_проектов

  5. Antwort des Dienstleisters auf unsere Support-Anfrage, warum die "REST-API" unseren "Accept: application/json" ignoriert und trotzdem immer mit HTML antwortet:

    "Die neue REST-API liefert immer nur HTML zurück, das ist so weit in Ordnung."

    Muss ich erwähnen, dass die URL-Pfade in keinster Weise #RESTful sind und GET-Requests Aktionen auslösen? 🫠

    Aber es gibt ein Swagger UI!😅

    #RestApi #SwaggerUI

  6. For REST 📡 API's written in Go 🚶, you should take a quick look at github.com/go-fuego/fuego. Getting an OpenAPI-Spec 📜 & a SwaggerUI 🖥️ without any extra effort, is a huge win!

    #REST #API #GoLang #OpenAPI #Swagger #SwaggerUI #Fuego #GoFuego #WebDevelopment #GoProgramming #APIManagement #ProgrammingTips #TechStack #OpenSource

  7. For REST 📡 API's written in Go 🚶, you should take a quick look at github.com/go-fuego/fuego. Getting an OpenAPI-Spec 📜 & a SwaggerUI 🖥️ without any extra effort, is a huge win!

    #REST #API #GoLang #OpenAPI #Swagger #SwaggerUI #Fuego #GoFuego #WebDevelopment #GoProgramming #APIManagement #ProgrammingTips #TechStack #OpenSource

  8. For REST 📡 API's written in Go 🚶, you should take a quick look at github.com/go-fuego/fuego. Getting an OpenAPI-Spec 📜 & a SwaggerUI 🖥️ without any extra effort, is a huge win!

    #REST #API #GoLang #OpenAPI #Swagger #SwaggerUI #Fuego #GoFuego #WebDevelopment #GoProgramming #APIManagement #ProgrammingTips #TechStack #OpenSource

  9. For REST 📡 API's written in Go 🚶, you should take a quick look at github.com/go-fuego/fuego. Getting an OpenAPI-Spec 📜 & a SwaggerUI 🖥️ without any extra effort, is a huge win!

    #REST #API #GoLang #OpenAPI #Swagger #SwaggerUI #Fuego #GoFuego #WebDevelopment #GoProgramming #APIManagement #ProgrammingTips #TechStack #OpenSource

  10. For REST 📡 API's written in Go 🚶, you should take a quick look at github.com/go-fuego/fuego. Getting an OpenAPI-Spec 📜 & a SwaggerUI 🖥️ without any extra effort, is a huge win!

    #REST #API #GoLang #OpenAPI #Swagger #SwaggerUI #Fuego #GoFuego #WebDevelopment #GoProgramming #APIManagement #ProgrammingTips #TechStack #OpenSource

  11. Генерируем в maven Java-модуль для OpenAPI из Swagger YAML

    Допустим отдел аналитики подготовил нам Swagger YAML с описанием API доступа к какому-то сервису: xyz-swagger-v1.0.0.yaml. Как автоматизировать генерацию библиотеки для доступа к API по этому описанию, если у вас maven? Полного мануала почему-то нигде нет, так что я собрал в одну всю информацию о реализации и возможных проблемах.

    habr.com/ru/articles/839358/

    #mvn #maven #mavenplugin #yaml #swagger #swaggerui #swaggerautogen #swaggerui #openapi

  12. Генерируем в maven Java-модуль для OpenAPI из Swagger YAML

    Допустим отдел аналитики подготовил нам Swagger YAML с описанием API доступа к какому-то сервису: xyz-swagger-v1.0.0.yaml. Как автоматизировать генерацию библиотеки для доступа к API по этому описанию, если у вас maven? Полного мануала почему-то нигде нет, так что я собрал в одну всю информацию о реализации и возможных проблемах.

    habr.com/ru/articles/839358/

    #mvn #maven #mavenplugin #yaml #swagger #swaggerui #swaggerautogen #swaggerui #openapi

  13. Генерируем в maven Java-модуль для OpenAPI из Swagger YAML

    Допустим отдел аналитики подготовил нам Swagger YAML с описанием API доступа к какому-то сервису: xyz-swagger-v1.0.0.yaml. Как автоматизировать генерацию библиотеки для доступа к API по этому описанию, если у вас maven? Полного мануала почему-то нигде нет, так что я собрал в одну всю информацию о реализации и возможных проблемах.

    habr.com/ru/articles/839358/

    #mvn #maven #mavenplugin #yaml #swagger #swaggerui #swaggerautogen #swaggerui #openapi

  14. Управление сервером со смартфона

    Из любого SSH-клиента можно установить канал с сервером и управлять им стандартными командами в консоли. Есть такие клиенты и для смартфона. Многие знают и используют консоль Termux под Android, которая запускает с телефона стандартный OpenSSH. Но есть варианты ещё удобнее, даже с графическим интерфейсом.

    habr.com/ru/companies/ruvds/ar

    #ruvds_статьи #RebootX_OnPrem #RebootX #Amazon_Web_Services #AWS #Microsoft_Azure #Clever_Cloud #Google_Cloud #GCP #OVH #Scaleway #Grafana #OpenAPI_Specification #SwaggerUI #Docker_Compose #swellsh #Bash #Tmux #Termux #bashcompletion #Webmin

  15. Управление сервером со смартфона

    Из любого SSH-клиента можно установить канал с сервером и управлять им стандартными командами в консоли. Есть такие клиенты и для смартфона. Многие знают и используют консоль Termux под Android, которая запускает с телефона стандартный OpenSSH. Но есть варианты ещё удобнее, даже с графическим интерфейсом.

    habr.com/ru/companies/ruvds/ar

    #ruvds_статьи #RebootX_OnPrem #RebootX #Amazon_Web_Services #AWS #Microsoft_Azure #Clever_Cloud #Google_Cloud #GCP #OVH #Scaleway #Grafana #OpenAPI_Specification #SwaggerUI #Docker_Compose #swellsh #Bash #Tmux #Termux #bashcompletion #Webmin

  16. Управление сервером со смартфона

    Из любого SSH-клиента можно установить канал с сервером и управлять им стандартными командами в консоли. Есть такие клиенты и для смартфона. Многие знают и используют консоль Termux под Android, которая запускает с телефона стандартный OpenSSH. Но есть варианты ещё удобнее, даже с графическим интерфейсом.

    habr.com/ru/companies/ruvds/ar

    #ruvds_статьи #RebootX_OnPrem #RebootX #Amazon_Web_Services #AWS #Microsoft_Azure #Clever_Cloud #Google_Cloud #GCP #OVH #Scaleway #Grafana #OpenAPI_Specification #SwaggerUI #Docker_Compose #swellsh #Bash #Tmux #Termux #bashcompletion #Webmin

  17. Yes, #SwaggerUI is a great tool to quickly host a reference documentation from an #OpenAPI file, however it's not very good with complex and nested data structures and descriptions will become unreadable. If you have such models in your #API, maybe look into different tools.

  18. I’ve updated a dependency producing #OpenAPI schema, which has also updated its OpenAPI spec version from 3.0 to 3.1 and #SwaggerUI that has just recently announced support for 3.1.
    Previous SwaggerUI rendering 3.1 spec does not show any of your tagged unions names - it just shows “object”.
    So this was an unexpected event considering that it is a minor version change and SwaggerUI is probably the most famous viewer for a OpenAPI schema.

    swagger.io/blog/swagger-suppor

  19. Fellow #dotNET developers, I have a repo that has already all #DTO objects and a #SwaggerUI #OpenAPI definition. Now I am about to write two clients—one will be an #ASPNETCore website using that API, the other is a .NET #MAUI client. Which route would you go for a client SDK that connects the clients with the #AzureFunctions API?

  20. über die dip api des bundestages sind nun auch kürzlich geänderte einträge abrufbar. siehe kapitel 2.6: draftable.com/compare/zKXNmlxO

    zudem sind ist die dokumentation neben der pdf-version auch in weiteren versionen verfügbar:

    swagger-ui
    search.dip.bundestag.de/api/v1

    openapi yaml
    search.dip.bundestag.de/api/v1

    #openbundestag #opendata #openparliaments #openapi #swaggerui

  21. über die dip api des bundestages sind nun auch kürzlich geänderte einträge abrufbar. siehe kapitel 2.6: draftable.com/compare/zKXNmlxO

    zudem sind ist die dokumentation neben der pdf-version auch in weiteren versionen verfügbar:

    swagger-ui
    search.dip.bundestag.de/api/v1

    openapi yaml
    search.dip.bundestag.de/api/v1

    #openbundestag #opendata #openparliaments #openapi #swaggerui

  22. über die dip api des bundestages sind nun auch kürzlich geänderte einträge abrufbar. siehe kapitel 2.6: draftable.com/compare/zKXNmlxO

    zudem sind ist die dokumentation neben der pdf-version auch in weiteren versionen verfügbar:

    swagger-ui
    search.dip.bundestag.de/api/v1

    openapi yaml
    search.dip.bundestag.de/api/v1

    #openbundestag #opendata #openparliaments #openapi #swaggerui

  23. über die dip api des bundestages sind nun auch kürzlich geänderte einträge abrufbar. siehe kapitel 2.6: draftable.com/compare/zKXNmlxO

    zudem sind ist die dokumentation neben der pdf-version auch in weiteren versionen verfügbar:

    swagger-ui
    search.dip.bundestag.de/api/v1

    openapi yaml
    search.dip.bundestag.de/api/v1

    #openbundestag #opendata #openparliaments #openapi #swaggerui

  24. über die dip api des bundestages sind nun auch kürzlich geänderte einträge abrufbar. siehe kapitel 2.6: draftable.com/compare/zKXNmlxO

    zudem sind ist die dokumentation neben der pdf-version auch in weiteren versionen verfügbar:

    swagger-ui
    search.dip.bundestag.de/api/v1

    openapi yaml
    search.dip.bundestag.de/api/v1

    #openbundestag #opendata #openparliaments #openapi #swaggerui

  25. I just started to implement #OpenAPI on my #AzureFunctions #API… seems like this will keep me busy all week long (as it is my private side project). Not sure about the #benefits for my #CASBAN6 project, though.
    #devlife #Azure #OpenWeb #SwaggerUI

  26. I just started to implement #OpenAPI on my #AzureFunctions #API… seems like this will keep me busy all week long (as it is my private side project). Not sure about the #benefits for my #CASBAN6 project, though.
    #devlife #Azure #OpenWeb #SwaggerUI

  27. I just started to implement #OpenAPI on my #AzureFunctions #API… seems like this will keep me busy all week long (as it is my private side project). Not sure about the #benefits for my #CASBAN6 project, though.
    #devlife #Azure #OpenWeb #SwaggerUI

  28. I just started to implement #OpenAPI on my #AzureFunctions #API… seems like this will keep me busy all week long (as it is my private side project). Not sure about the #benefits for my #CASBAN6 project, though.
    #devlife #Azure #OpenWeb #SwaggerUI

  29. I just started to implement #OpenAPI on my #AzureFunctions #API… seems like this will keep me busy all week long (as it is my private side project). Not sure about the #benefits for my #CASBAN6 project, though.
    #devlife #Azure #OpenWeb #SwaggerUI

  30. Is anyone aware of a UI constructor for OpenAPI-defined APIs that goes beyond Swagger UI?

    Swagger UI is a great leap over just having API documentation and making your own HTTP requests, it literally generates a UI, if a barebones one, that not only knows the endpoints but even knows and helps you conform to the datatypes.

    It would be awesome to have some low-code tool with very high whipuptitude that would allow you to create a working prototype of a more visual UI by just dragging some stuff around.

    #OpenAPI #swagger #SwaggerUI