API Reference

This document describes the IngenioLens web API for developers building on top of the platform.

Base URL

https://api.ingeniolens.com/v1

Authentication

All API requests require a bearer token:

Authorization: Bearer YOUR_API_KEY

API keys are available from the IngenioLens developer portal.

Endpoints

Search Physics Concepts

GET /search

Query parameters:

| Parameter | Type | Required | Description | |-----------|--------|----------|--------------------| | q | string | Yes | Natural language query |

Response:

{
  "results": [
    {
      "id": "spring",
      "title": "Spring Oscillator Lab",
      "type": "lab",
      "url": "/labs/spring",
      "score": 0.92
    }
  ]
}

---

Get Lab Data

GET /labs/{labId}

Path parameters:

| Parameter | Values | |-----------|-------------------------------------| | labId | spring, structural, taylor |

Response:

{
  "id": "spring",
  "name": "Spring Oscillator Lab",
  "formula": "T = 2π√(m/k)",
  "parameters": [
    { "name": "mass", "unit": "kg", "min": 0.1, "max": 10 },
    { "name": "k",    "unit": "N/m", "min": 0.1, "max": 10 },
    { "name": "b",    "unit": "",    "min": 0,   "max": 5  }
  ]
}

---

Submit Feedback

POST /feedback

Request body:

{
  "type": "bug | feature | general",
  "message": "Your feedback here",
  "email": "optional@email.com"
}

Response:

{ "ok": true, "id": "fb_abc123" }

---

Rate Limits

| Tier | Requests / minute | |---------|-------------------| | Free | 100 | | Pro | 1,000 | | Enterprise | Unlimited |

Error Codes

| Code | Meaning | |------|----------------------------| | 400 | Bad request / missing param | | 401 | Invalid or missing API key | | 404 | Resource not found | | 429 | Rate limit exceeded | | 500 | Internal server error |