Preview
Sign inSign up
API/v1/demo

API

Anonymous evaluation for the site's try-it box

POSThttps://api.cons.stneto.dev/v1/demoNo key

No key, tighter limits (500 ms, 1M steps, 4 KB source, 50 compound expressions). Only the site's origin may call it, and each IP gets 10 runs a minute and 100 a day.

Request

No key needed.

Not for your own code

This endpoint serves the try-it box on this site. Requests from any other origin get 403. Use /v1/eval with a key instead.

Body EvalRequest · application/json

FieldDescription
source
string · required
Scheme source. At most 64 KB on the API, 4 KB on the demo.
timeout_ms
integer · optional
Wall-clock limit. API default 1000, max 5000. The demo uses 500 and allows at most 500.

Responses

StatusMeaning
200The program ran.
400The body isn't valid JSON (invalid_json).
403The request didn't come from the site's origin (forbidden_origin).
413Source over the limit (source_too_large) or body over 1 MB (request_too_large).
422Missing or non-string source, or bad timeout_ms (invalid_request).
429Per-IP rate limit (rate_limited).
Headers: Retry-After
503Every evaluation slot is taken (busy). Retry shortly.

Response body EvalResponse

FieldDescription
status
string · required
One of ok, error, timeout, limit_exceeded.
results
Result[] · required
The forms that finished, in order.
stdout
string · required
—
stdout_truncated
boolean · required
—
stats
Stats · required
—
error
EvalError | null · required
—
request_id
string · required
—

Example

request
curl -sS https://api.cons.stneto.dev/v1/demo \
  -H "Content-Type: application/json" \
  -d '{"source": "(+ 1 2)"}'
200 OK · application/json
{
  "status": "ok",
  "results": [
    {"index": 0, "line": 1, "col": 1, "value": null, "json": null},
    {"index": 1, "line": 2, "col": 1, "value": "(1 4 9)", "json": [1, 4, 9]}
  ],
  "stdout": "",
  "stats": {"wall_ms": 0.21, "cpu_ms": 0.02, "steps": 25},
  "error": null,
  "request_id": "req_8k2j4h5g6f7d8s9a0p1o"
}
esc