API

Basivis exposes a single POST endpoint for structural analysis. The API is stateless, quiet, and produces reproducible output based solely on the provided fields.

Endpoint

All analysis requests are sent to the following URL:

POST https://www.basivis.ch/api/analyze

Method

Only POST is accepted. Other HTTP methods are rejected immediately.

Headers

A valid Basivis key and JSON content type are required.

X-Basivis-Key: basivis_public_live_01
Content-Type: application/json

Body

The request body contains four required fields. Each field must be a deterministic string between 10 and 2000 characters. Arrays and short strings are rejected.

{
  "direction": "north movement with clear structural intent",
  "tragline": "underlying backbone principle guiding the system",
  "elements": "beam and joint system forming the core structure",
  "constraints": "limit:10 with no external pressure applied"
}

Response

The API returns a deterministic JSON object. No data is stored, tracked, or learned from.

{
  "score": 72,
  "summary": "structural overview of the provided input",
  "blindspots": "identified areas lacking clarity",
  "integrity": "assessment of internal consistency",
  "improvements": "suggested structural refinements",
  "tension": "detected opposing forces within the input",
  "signals": "extracted structural indicators",
  "balance": "evaluation of directional stability"
}