API Overview¶

Complete reference for the Tajiri Vision API.

Base URL¶

https://api.tajirifarm.com

Endpoints¶

Method	Endpoint	Description
`POST`	`/diagnosis/`	Analyze a plant image and get diagnosis
`GET`	`/health`	Check API health status
`GET`	`/docs`	Interactive Swagger UI documentation
`GET`	`/redoc`	ReDoc API documentation
`GET`	`/openapi.json`	OpenAPI 3.0 specification

Request Format¶

All diagnosis requests use multipart/form-data:

POST /diagnosis/ HTTP/1.1
Host: api.tajirifarm.com
Content-Type: multipart/form-data; boundary=----FormBoundary

------FormBoundary
Content-Disposition: form-data; name="image"; filename="plant.jpg"
Content-Type: image/jpeg

[binary image data]
------FormBoundary
Content-Disposition: form-data; name="crop_type"

tomato
------FormBoundary--

Response Format¶

All responses are JSON:

HTTP/1.1 200 OK
Content-Type: application/json
X-Request-ID: 550e8400-e29b-41d4-a716-446655440000

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "is_plant": true,
  "crop_health": "unhealthy",
  ...
}

Supported Image Formats¶

Format	MIME Type	Max Size
JPEG	`image/jpeg`	10 MB
PNG	`image/png`	10 MB
WebP	`image/webp`	10 MB
HEIC	`image/heic`	10 MB
HEIF	`image/heif`	10 MB

Supported Languages¶

Code	Language
`en`	English
`fr`	French (default)
`sw`	Swahili
`es`	Spanish
`pt`	Portuguese
`it`	Italian

Detail Levels¶

Level	Target Audience	Description
`simple`	Farmers	Plain language, essential information only
`standard`	Technicians	Balanced technical detail (default)
`expert`	Agronomists	Full scientific terminology and details

HTTP Status Codes¶

Code	Description
`200`	Success
`400`	Bad Request (invalid image, parameters)
`422`	Validation Error
`429`	Rate Limit Exceeded
`500`	Internal Server Error

Health Check¶

curl https://api.tajirifarm.com/health

Response:

{
  "status": "healthy",
  "version": "1.0.0"
}