Skip to content

Developers

ALPA Developer Resources

Machine-readable discovery for alpa.llc, including the ALPA Public API, OpenAPI specification, Markdown representations, and agent indexes.

Quick start

The ALPA Public API is a small, read-only discovery API. It is versioned independently from ALPA products and does not expose client portal or project data.

curl https://alpa.llc/api
curl https://alpa.llc/api/site
curl https://alpa.llc/openapi.json

OpenAPI specification

The canonical OpenAPI 3.1 document is published at https://alpa.llc/openapi.json. Use it to discover supported operations, schemas, status codes, and error formats.

API endpoints

  • GET /api — API version, endpoint index, and documentation links.
  • GET /api/site — ALPA identity and canonical machine-readable resource URLs.

JSON errors

Every /api/ error is JSON with a stable code, a message, and a resolution hint:

{
  "error": {
    "code": "not_found",
    "message": "No ALPA API endpoint exists at /api/example.",
    "resolution": "Use GET /api or inspect https://alpa.llc/openapi.json for supported endpoints.",
    "documentation_url": "https://alpa.llc/developers/"
  }
}

Markdown content negotiation

Public editorial pages have generated Markdown representations at the same canonical URLs. Request one with Accept: text/markdown:

curl -H "Accept: text/markdown" https://alpa.llc/about/

Negotiated HTML and Markdown responses include Vary: Accept. HTML responses also advertise their Markdown sibling with Link: rel="alternate"; type="text/markdown".

Authentication

No authentication or credentials are required for the public endpoints documented in openapi.json. The password-protected client portal is separate and is not part of the ALPA Public API.

MCP and webhooks

alpa.llc does not currently expose a public MCP server or webhook API. Product-specific agent integrations are documented with each product; Norma provides its own MCP access, separate from this website API.

Machine-readable resources

← Home