📚 API Documentation

REST API endpoints for CLIK AGRITECH Platform

🔐 Authentication

All protected endpoints require a Bearer JWT token in the Authorization header.

Authorization: Bearer <your_jwt_token>

🚀 Available Endpoints

Description: Authenticate user and return JWT token

Request Body:

{
  "email": "user@example.com",
  "password": "password"
}

Response:

{
  "success": true,
  "message": "Authentification réussie",
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": 1,
    "name": "John Doe",
    "email": "user@example.com",
    "role": "agriculteur"
  }
}

Description: Get all products (requires authentication)

Headers:

Authorization: Bearer <token>

Response:

{
  "success": true,
  "count": 10,
  "data": [...]
}

Description: Get single product by ID (requires authentication)

Headers:

Authorization: Bearer <token>

Response:

{
  "success": true,
  "data": {
    "id": 1,
    "name": "Fèves de Cacao",
    "price": 1500.00,
    ...
  }
}

Description: Get weather alerts and forecast (requires authentication)

Headers:

Authorization: Bearer <token>

Response:

{
  "success": true,
  "region": "Yamoussoukro",
  "alerts": [...],
  "forecast": [...]
}

⚠️ Error Codes

Code Description
401 Unauthorized - Missing or invalid token
403 Forbidden - Insufficient permissions
404 Not Found - Endpoint doesn't exist
400 Bad Request - Invalid input parameters