HTTP API Documentation

REST API reference for the Drone Research Agent. All endpoints return JSON responses.

Base URL

https://drone-research-agent.dronecraft.co/api/v1

Endpoints

POST/search-documents

Search through documents in Google Drive for drone research.

Request Body

{
  "q": "battery thermal management",
  "limit": 10  // optional, 1-50, default: 10
}

Response

{
  "results": [
    {
      "title": "Document title",
      "snippet": "Matching content...",
      "url": "https://drive.google.com/...",
      "mimeType": "application/pdf"
    }
  ],
  "count": 5
}
POST/analyze-component

Analyze technical specifications for drone components.

Request Body

{
  "component_type": "motor",  // motor | esc | battery | propeller | frame | fc | other
  "specs": "2207 1750KV, 4S-6S, 28A max current",
  "use_case": "racing"  // optional: racing | cinematography | delivery | etc.
}

Response

{
  "analysis": {
    "component_type": "motor",
    "suitability": "Excellent for racing",
    "key_specs": {...},
    "recommendations": [...]
  }
}
POST/summarize-content

Extract key insights from technical documents.

Request Body

{
  "text": "Full document text...",
  "focus": "battery safety"  // optional: specific aspect to focus on
}

Response

{
  "summary": "Key findings and insights...",
  "key_points": [
    "Point 1",
    "Point 2"
  ]
}
POST/compare-components

Compare multiple drone components side-by-side.

Request Body

{
  "components": [
    "T-Motor F60 Pro IV",
    "iFlight XING2 2207"
  ],  // 2-5 components
  "criteria": ["weight", "thrust", "efficiency"]  // optional
}

Response

{
  "comparison": {
    "components": [...],
    "criteria": [...],
    "winner": "Component with best overall score",
    "details": {...}
  }
}

Rate Limits

  • 120 requests per minute
  • 5,000 requests per hour

Rate limits are per IP address. When you exceed the limit, you will receive a 429 Too Many Requests response with Retry-After header.

Error Responses

400 Bad Request

Invalid request parameters

429 Too Many Requests

Rate limit exceeded

500 Internal Server Error

Server error

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please try again later."
  }
}

OpenAPI Specification

Full OpenAPI 3.x specification is available at:

GET https://drone-research-agent.dronecraft.co/.well-known/openapi.json
Documentation HomeTerms of ServicePrivacy PolicyHome