ILYASAPI

DOCUMENTATION

Simple endpoints.
Clear contracts.

GET

/api/v1/health

Public service health. Does not expose secrets or infrastructure details.

GET

/api/v1/ping

Requires Authorization: Bearer API_KEY.

{
  "ok": true,
  "message": "pong",
  "timestamp": "2026-01-01T00:00:00Z"
}
POST

/api/v1/echo

Requires an API key. JSON body is returned as data.

curl -X POST https://ilyasapi.duckdns.org/api/v1/echo \
  -H "Authorization: Bearer ng_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"hello":"world"}'
Errors 
{
  "ok": false,
  "error": {
    "code": "invalid_api_key",
    "message": "API key is invalid or revoked."
  }
}