# MaqAgr API ## Docs - [Login](https://mintlify.wiki/David9604/BackMaqagr/api-reference/auth/login.md): Authenticate a user and receive a JWT token - [Logout](https://mintlify.wiki/David9604/BackMaqagr/api-reference/auth/logout.md): End the user session - [Change Password](https://mintlify.wiki/David9604/BackMaqagr/api-reference/auth/password.md): Update the authenticated user password - [User Profile](https://mintlify.wiki/David9604/BackMaqagr/api-reference/auth/profile.md): Get or update the authenticated user profile - [Register User](https://mintlify.wiki/David9604/BackMaqagr/api-reference/auth/register.md): Create a new user account in the system - [Calculation History](https://mintlify.wiki/David9604/BackMaqagr/api-reference/calculations/history.md): Retrieve the user calculation history - [Calculate Minimum Power](https://mintlify.wiki/David9604/BackMaqagr/api-reference/calculations/minimum-power.md): Calculate minimum power required for an implement and get tractor recommendations - [Calculate Power Loss](https://mintlify.wiki/David9604/BackMaqagr/api-reference/calculations/power-loss.md): Calculate power losses for a tractor operating on specific terrain - [Create Implement](https://mintlify.wiki/David9604/BackMaqagr/api-reference/implements/create.md): Add a new agricultural implement to the catalog (Admin only) - [Delete Implement](https://mintlify.wiki/David9604/BackMaqagr/api-reference/implements/delete.md): Remove an agricultural implement from the catalog (Admin only - Soft delete) - [Get Implement](https://mintlify.wiki/David9604/BackMaqagr/api-reference/implements/get.md): Retrieve a specific implement by ID, get available implements, or search with advanced filters - [List Implements](https://mintlify.wiki/David9604/BackMaqagr/api-reference/implements/list.md): Retrieve a paginated list of all agricultural implements with optional filtering - [Update Implement](https://mintlify.wiki/David9604/BackMaqagr/api-reference/implements/update.md): Modify an existing agricultural implement in the catalog (Admin only) - [Generate Recommendations](https://mintlify.wiki/David9604/BackMaqagr/api-reference/recommendations/generate.md): Generate intelligent tractor recommendations for a specific terrain and implement - [Get Recommendation](https://mintlify.wiki/David9604/BackMaqagr/api-reference/recommendations/get.md): Retrieve detailed recommendation by ID - [Recommendation History](https://mintlify.wiki/David9604/BackMaqagr/api-reference/recommendations/history.md): Retrieve user recommendation history - [Create Role](https://mintlify.wiki/David9604/BackMaqagr/api-reference/roles/create.md): Create a new role in the system (Admin only) - [Delete Role](https://mintlify.wiki/David9604/BackMaqagr/api-reference/roles/delete.md): Delete a role (Admin only) - [Get Role by ID](https://mintlify.wiki/David9604/BackMaqagr/api-reference/roles/get.md): Get details of a specific role - [List Roles](https://mintlify.wiki/David9604/BackMaqagr/api-reference/roles/list.md): Get a paginated list of all active roles in the system - [Update Role](https://mintlify.wiki/David9604/BackMaqagr/api-reference/roles/update.md): Update an existing role (Admin only) - [Create Terrain](https://mintlify.wiki/David9604/BackMaqagr/api-reference/terrains/create.md) - [Delete Terrain](https://mintlify.wiki/David9604/BackMaqagr/api-reference/terrains/delete.md) - [Get Terrain](https://mintlify.wiki/David9604/BackMaqagr/api-reference/terrains/get.md) - [List Terrains](https://mintlify.wiki/David9604/BackMaqagr/api-reference/terrains/list.md) - [Update Terrain](https://mintlify.wiki/David9604/BackMaqagr/api-reference/terrains/update.md) - [Create Tractor](https://mintlify.wiki/David9604/BackMaqagr/api-reference/tractors/create.md): Add a new tractor to the catalog (admin only) - [Delete Tractor](https://mintlify.wiki/David9604/BackMaqagr/api-reference/tractors/delete.md): Remove a tractor from the catalog (admin only) - [Get Tractor](https://mintlify.wiki/David9604/BackMaqagr/api-reference/tractors/get.md): Retrieve a specific tractor by ID, get available tractors, or search with advanced filters - [List Tractors](https://mintlify.wiki/David9604/BackMaqagr/api-reference/tractors/list.md): Get a paginated list of all tractors with optional filters - [Update Tractor](https://mintlify.wiki/David9604/BackMaqagr/api-reference/tractors/update.md): Modify an existing tractor in the catalog (admin only) - [Authentication](https://mintlify.wiki/David9604/BackMaqagr/authentication.md): Learn how to authenticate with the MaqAgr API using JWT tokens - [Deployment](https://mintlify.wiki/David9604/BackMaqagr/development/deployment.md): Complete guide for deploying the MaqAgr API to production, including environment setup, database configuration, and Docker deployment - [Error Handling](https://mintlify.wiki/David9604/BackMaqagr/development/error-handling.md): Comprehensive guide to error handling patterns, middleware, and response formats in the MaqAgr API - [Testing](https://mintlify.wiki/David9604/BackMaqagr/development/testing.md): Complete testing guide for the MaqAgr API including unit tests, integration tests, and coverage reports - [Utilities](https://mintlify.wiki/David9604/BackMaqagr/development/utilities.md): Comprehensive guide to utility functions and helpers available in the MaqAgr API - [Power Loss Calculations](https://mintlify.wiki/David9604/BackMaqagr/features/calculations.md): Physics-based power loss calculations for agricultural tractors using ASABE standards - [Tractor Recommendations](https://mintlify.wiki/David9604/BackMaqagr/features/recommendations.md): Intelligent multi-criteria scoring algorithm for optimal tractor-implement-terrain matching - [Introduction](https://mintlify.wiki/David9604/BackMaqagr/introduction.md): Welcome to MaqAgr API - A robust REST API for comprehensive agricultural machinery management - [Quick Start](https://mintlify.wiki/David9604/BackMaqagr/quickstart.md): Get up and running with MaqAgr API in minutes - [Implements](https://mintlify.wiki/David9604/BackMaqagr/resources/implements.md): Comprehensive guide to the Implement resource in the MaqAgr API - [Terrains](https://mintlify.wiki/David9604/BackMaqagr/resources/terrains.md): Comprehensive guide to the Terrain resource in the MaqAgr API - [Tractors](https://mintlify.wiki/David9604/BackMaqagr/resources/tractors.md): Comprehensive guide to the Tractor resource in the MaqAgr API ## OpenAPI Specs - [openapi](https://mintlify.wiki/David9604/BackMaqagr/api-reference/openapi.json)