System Interface

API Documentation

Interact programmatically with the Disaster Detection Platform. Our RESTful API on FastAPI processes imagery and manages inference queues.

POST

/api/v1/detect

Upload Image for Detection

Submit a disaster image for processing. The image is passed to the GPU workers via Redis queue.

cURL Example

curl -X POST http://YOUR_IP/api/v1/detect \
  -F "[email protected]" \
  -F "priority=normal"
GET

/api/v1/jobs/{job_id}

Check Job Status

Retrieve the current status of an ongoing detection job (e.g. pending, processing, completed, failed).

cURL Example

curl http://YOUR_IP/api/v1/jobs/123e4567-e89b-12d3...
GET

/api/v1/results/{job_id}

Get Detection Results

Once completed, fetch the full inference results including disaster type, confidence score, and bounding boxes.

cURL Example

curl http://YOUR_IP/api/v1/results/123e4567-e89b-12d3...
GET

/api/v1/stats

Platform Statistics

Get overall statistics of the AI platform including number of detections, device metrics, and system load.

cURL Example

curl http://YOUR_IP/api/v1/stats