Developer portal

API guide

The MVP centers on one endpoint: `/optimize`. Developers submit a problem, Qtangl runs the solver workflow, and the service returns a structured result.

Request schema

{
  "type": "schedule | routing | allocation",
  "data": {},
  "constraints": []
}

Response schema

{
  "status": "success",
  "solution": {},
  "cost": 12,
  "method": "qaoa",
  "backend": "ibm_qasm_simulator"
}

Authentication

The MVP assumes API-key based authentication. Requests include a bearer token or API key header managed by the client application.

Rate limits

MVP rate limiting is capped at 10 requests per minute per API key. This is enough for testing and pilot workflows without overcomplicating usage.

Error handling

Invalid input
Unsupported problem type
Solver failure
Timeout