📚 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 |