Salfio
APIReference

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.

GET
/openapi.yaml

Response Body

application/yaml

application/json

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

Update a card (Planned)

**Planned** — declared in v1 but not yet implemented. Returns `200 { data: null, meta: {} }` today.

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).