Tellico Tractor Works — Website API

This documents the public HTTP API surface of the Tellico Tractor Works website (residential and agricultural tractor services in Tellico Plains, Tennessee, serving Monroe, Blount, Loudon, McMinn, and Polk Counties).

Discovery RFC 9727

Automated agents discover this API via the RFC 9727 well-known catalog:

GET https://www.tellicotractorworks.com/.well-known/api-catalog
Accept: application/linkset+json

The catalog returns a linkset advertising the links below.

Links

RelationURLMedia type
service-desc/api/openapi.jsonapplication/vnd.oai.openapi+json;version=3.1
service-doc/api/docs.htmltext/html
status/api/health.jsonapplication/health+json

OpenAPI Specification

The machine-readable OpenAPI 3.1 specification is available at /api/openapi.json. It documents the website's public page endpoints, the discovery catalog, and the health endpoint.

Health

GET https://www.tellicotractorworks.com/api/health.json
Content-Type: application/health+json

{ "status": "pass", "version": "1", "service": "tellico-tractor-works-website" }

Agent Authentication & Registration auth.md

Autonomous agents discover authentication and registration support via /auth.md, a Markdown document with an H1 heading containing auth.md. It identifies the agent audience, the supported registration method (email provisioning), and how issued bearer credentials are used (in the Authorization header).

The resource server also publishes OAuth metadata so agents can resolve token issuance and registration endpoints automatically:

DocumentURLMedia type
OAuth Protected Resource Metadata RFC 9728/.well-known/oauth-protected-resourceapplication/json
OAuth Authorization Server Metadata RFC 8414/.well-known/oauth-authorization-serverapplication/json

The Protected Resource Metadata advertises resource, authorization_servers, scopes_supported, and bearer_methods_supported (including header). The Authorization Server Metadata includes a valid issuer matching the issuer advertised in the Protected Resource Metadata, plus an agent_auth block with skill, register_uri, and the supported registration method.

Contact

Phone: 423-509-5565 · Email: [email protected] · Contact page