Skip to content

feat: Add Swagger and Postman support#5

Merged
Codegres-com merged 1 commit intomainfrom
feature/swagger-postman-docs
Sep 30, 2025
Merged

feat: Add Swagger and Postman support#5
Codegres-com merged 1 commit intomainfrom
feature/swagger-postman-docs

Conversation

@Codegres-com
Copy link
Copy Markdown
Owner

This commit introduces Swagger UI for interactive API documentation and a Postman collection for easy API testing.

  • Adds swagger-ui-express and swagger-jsdoc to handle documentation generation and serving.
  • Implements JSDoc comments across all API routes in src/routes/api.js to define the API specification.
  • Creates a new endpoint, /api-docs, to serve the interactive Swagger UI. The UI is pre-configured to use the master API key for immediate testing.
  • Generates a whatsapp_api_collection.json file in the root directory. The collection includes all endpoints and a pre-request script to manage the X-MASTER-KEY header automatically.
  • Updates README.md with a new "API Documentation" section, explaining how to access the Swagger UI and import the Postman collection.

This commit introduces Swagger UI for interactive API documentation and a Postman collection for easy API testing.

- Adds `swagger-ui-express` and `swagger-jsdoc` to handle documentation generation and serving.
- Implements JSDoc comments across all API routes in `src/routes/api.js` to define the API specification.
- Creates a new endpoint, `/api-docs`, to serve the interactive Swagger UI. The UI is pre-configured to use the master API key for immediate testing.
- Generates a `whatsapp_api_collection.json` file in the root directory. The collection includes all endpoints and a pre-request script to manage the `X-MASTER-KEY` header automatically.
- Updates `README.md` with a new "API Documentation" section, explaining how to access the Swagger UI and import the Postman collection.
@Codegres-com Codegres-com merged commit 51bed95 into main Sep 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant