Spec

Frammenti di codice

curl "https://api.oanor.com/crankslider-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/crankslider-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/crankslider-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/crankslider-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "notes": "Lengths in metres, angle in degrees from top dead centre, speed as rpm or angular_velocity (rad/s). Acceleration is the standard two-term approximation.",
        "service": "crankslider-api",
        "formulae": {
            "stroke": "2·r,  max rod angle = asin(λ)",
            "velocity": "v = ω·[r·sinθ + r·λ·sinθcosθ/√(1−λ²sin²θ)]",
            "acceleration": "a ≈ r·ω²·(cosθ + λ·cos2θ)",
            "displacement": "x = r(1−cosθ) + l(1 − √(1−λ²sin²θ)),  λ = r/l"
        },
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/geometry": "Stroke, rod ratio, dead-centre positions, maximum rod angle and mean piston speed.",
            "GET /v1/position": "Piston displacement from TDC, distance from crank axis and connecting-rod angle at a crank angle.",
            "GET /v1/velocity": "Exact piston velocity and approximate acceleration at a crank angle for a given crank speed."
        },
        "description": "Slider-crank (piston-crank) mechanism kinematics: piston position, velocity, acceleration and mechanism geometry from crank radius, rod length and angle."
    },
    "meta": {
        "timestamp": "2026-06-04T10:18:36.383Z",
        "request_id": "cdb7b288-c7bc-42dc-a5b7-a68a23824ef1"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}