Salfio
APIReference

Render the Public API v1 documentation (Scalar)

Renders an interactive API reference (Scalar) that points at `/v1/openapi.yaml`. Unauthenticated — intended for prospective partners to preview the API surface before minting a key. Rate- limited per caller IP (60 req/min).

GET
/docs

Response Body

text/html

application/json

curl -X GET "https://api.salfio.com/v1/docs"
"string"
{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded",
    "details": {
      "retry_after_seconds": 30
    }
  }
}

Fetch the Public API v1 OpenAPI specification

Returns this very document as `application/yaml`. Unauthenticated — the spec is public. Rate-limited per caller IP (60 req/min) and cacheable for 5 minutes at the edge.

Changelog

Significant changes to Salfio. Automation is a follow-up — this is a placeholder for now.