crud-person-api Simple Person API
This is a simple REST API for managing persons.
Table of Contents
- Introduction
- Features
- Endpoints
- Getting Started
- Usage
- Documentation
- UML Diagram
- Testing
- Contributing
- License
Introduction
This REST API allows you to perform CRUD operations on a "person" resource. You can add, retrieve, update, and delete person records using this API.
Features
- Create a new person record.
- Retrieve details of a person by ID.
- Update the details of an existing person.
- Delete a person by ID.
- Flexible parameter handling for dynamic queries.
- Input validation for person names.
Endpoints
POST /api
: Create a new person.GET /api/{user_id}
: Retrieve details of a person.PUT /api/{user_id}
: Update the details of a person.DELETE /api/{user_id}
: Delete a person.
Getting Started
Follow these steps to set up and run the API locally:
- Clone this repository.
- Install the required dependencies (
pip install -r requirements.txt
). - Configure your database settings in
config.py
. - Run the API using
python app.py
.
For detailed deployment instructions, please refer to the documentation.
Usage
To use the API, make HTTP requests to the provided endpoints. You can find examples and detailed request/response formats in the documentation.
Documentation
Please refer to the documentation for detailed information on request/response formats, sample usage, and deployment instructions.
UML Diagram
For a detailed UML diagram description, please see the documentation.
Testing
To test the API, you can use tools like Postman or Python scripts with the requests
library. Comprehensive testing instructions can be found in the documentation.
Contributing
Contributions are welcome! Please follow our contributing guidelines.
License
This project is licensed under the MIT License - see the LICENSE file for details.