Aerix Developer & Agent Resources

Everything you need to read Aerix programmatically — markdown content negotiation, an OpenAPI spec, and a machine-readable index of the whole site.

Aerix is readable by machines, not just browsers

Every public page on this site is published in two representations at the same URL: HTML for people, and Markdown for language models, agents and scripts. There is no API key, no rate limit and no sign-up. If you are building a tool that needs to read what Aerix does, where we operate, or what our networks cost, the Markdown representation is the one to fetch.

Aerix Content API

The Content API is content negotiation rather than a separate service: the same paths you see in a browser return Markdown when you ask for it. It is described formally in our OpenAPI 3.1 specification.

Method 1 — append .md to any public path

curl https://www.aerix.uk/about.md
curl https://www.aerix.uk/services/rural-networks.md
curl https://www.aerix.uk/index.md          # the homepage

Method 2 — send an Accept header

curl -H "Accept: text/markdown" https://www.aerix.uk/
curl -H "Accept: text/markdown" https://www.aerix.uk/coverage

Caching and Vary

Because both representations live at one URL, every negotiated response carries Vary: Accept, Accept-Encoding. Shared caches therefore key the HTML and Markdown variants separately, and an agent asking for Markdown will never be handed a cached HTML page. Markdown responses are cacheable for an hour at the client and a day at the edge.

What is not negotiable

Authenticated areas — /admin, /custadmin, /projects, /neutralhost, /bizadmin — and /api have a single representation and ignore the Accept header. Our customer, billing, probe-telemetry and webhook APIs are authenticated and are not documented here; if you need access to them, get in touch.

Machine-readable files

Each of these lives at a predictable, stable URL:

llms.txt /llms.txt · text/plain

Index of every public Aerix page with its markdown URL, following the llms.txt convention.

OpenAPI specification /openapi.json · application/json

OpenAPI 3.1 description of the Aerix Content API — the markdown negotiation interface described below.

XML sitemap /sitemap.xml · application/xml

Every indexable page with last-modified dates, regenerated per request.

robots.txt /robots.txt · text/plain

Crawl policy. AI crawlers are explicitly allowed, and the markdown API is opened to all agents.

Using Aerix content in an AI product

You are welcome to read, quote and summarise this site, and our robots.txt says so explicitly for the major AI crawlers. We ask two things: attribute Aerix and link to the canonical page you drew from, and fetch the Markdown representation rather than scraping the HTML — it is smaller, cleaner, and it means a design change on our side will not silently break your parser.

Integrations and API access

Aerix operates private 5G networks, and the operational interfaces behind them — SIM provisioning, subscriber management, network telemetry — are authenticated and offered to partners rather than published openly. If you are integrating with an Aerix network, or you would like a webhook or an MCP server for something we do not yet expose, write to team@aerix.uk and tell us what you are building. We would rather hear the use case than guess at it.