Utkarshblogs.utkarshrajput.com·Oct 14, 2024Document you NodeJS APIs the best wayIntroduction As a Node.js developer, I’ve faced the same issue countless times: you build an awesome API with Express.js, it works great, and then… documentation. The excitement fizzles out. Let’s be real, no one loves documenting APIs, but we all ap...Discussdocumentation
Tina Hollyblog.tinaciousdesign.com·Oct 14, 2024Open API (Part 3): Generating an OpenAPI spec file from codeOverview This is the 3rd article in a series of posts about working with Open API to create generated API clients and documentation websites. In the 1st post we went over what we can do with Open API spec files, e.g. generate API clients and documen...Discuss·60 readsOpenApi
Tina Hollyblog.tinaciousdesign.com·Oct 7, 2024Open API (Part 2): Handcrafted, bespoke, artisanal Open API specs: API contract-firstOverview This article is the 2nd in a series of blog posts that discuss using Open API to help with API documentation and API client code generation. In the previous article, we went over how we can generate documentation and API clients using existi...Discuss·10 likesOpenApi
Tina Hollyblog.tinaciousdesign.com·Sep 30, 2024Open API (Part 1): Generating API clients and documentation from an Open API specOverview This article starts a series of Open API-related blog posts. OpenAPI, previously known as Swagger (a name still in use today for many of its tools), is a suite of tools that generate documentation and networking clients for various programmi...DiscussOpenApi
Andy Blackledgewww.10printiamcool.com·Sep 22, 2024Using Microsoft.OpenApiReader to create a dynamic REST API clientIn my previous post, I discovered the Microsoft.OpenApi packages and used them to extract JSON schemas from an Open API document. At the end of that post, I pondered if it would be possible to build on my experience to create a client that could be u...Discuss·31 readsAdventures with Microsoft.OpenApiReader and REST clientsC#
Andy Blackledgewww.10printiamcool.com·Aug 19, 2024Validating JSON Requests Using C# and OpenAPI/SwaggerRecently, I needed to integrate an internal system that generates JSON with a third-party API. Usefully, I had an OpenAPI specification for the API in question. OpenAPI is a specification for machine-readable interface files for describing, producing...Discuss·154 readsAdventures with Microsoft.OpenApiReader and REST clientsC#
Arnab guptaarnabgupta.hashnode.dev·Jul 20, 2024How to Integrate Swagger in Node Express for API DocumentationAs an API developer, I always aim to provide good documentation for the code I write. What better way to do that than by using Swagger? So today, I will write a guide on setting up Swagger with your Node Express project. Start New Project npm init -y...Discussswagger-ui
ByteScrum TechnologiesforByteScrum Technologiesblog.bytescrum.com·Jul 18, 2024Building Powerful APIs with NestJS ControllersNestJS is a progressive Node.js framework that allows you to build efficient, reliable, and scalable server-side applications. One of the key components of a NestJS application is the controller, which is responsible for handling incoming requests, p...Discuss·60 likes·69 readsnest controller
Youssef Khaledyoussefkhaled.hashnode.dev·Jun 22, 2024Swagger Advanced Schemas: Arrays and Nested ObjectsIn our previous articles, we covered the basics of Swagger, defining API endpoints and operations, creating schemas to promote reusability, and adding examples to your Swagger documentation. In this article, we will explore how to use advanced schema...Discuss·27 readsSwagger Simplifiedsoftware development
Youssef Khaledyoussefkhaled.hashnode.dev·Jun 18, 2024Adding Examples to Swagger DocumentationIn our previous articles, we covered the basics of Swagger, defining API endpoints and operations, and creating schemas to promote reusability. In this article, we will focus on adding examples to your Swagger documentation. Examples are invaluable f...DiscussSwagger SimplifiedTutorial