# Developer resources

> Public, read-only machine interfaces for arash.am.

## When to use them

Use the JSON API for canonical site and post metadata. Use llms.txt for a compact editorial map and attribution guidance. Use RSS when full post bodies are needed.

## Endpoints

- [Site profile](https://arash.am/api/site.json)
- [Published posts](https://arash.am/api/posts.json)
- [OpenAPI 3.1](https://arash.am/openapi.json)
- [API catalog](https://arash.am/.well-known/api-catalog)
- [llms.txt](https://arash.am/llms.txt)
- [RSS feed](https://arash.am/feed.xml)

## Markdown

Every public page has a Markdown representation. Send `Accept: text/markdown` to its canonical URL or append `.md` to the extensionless path. The home twin is `/index.md`.

Unknown paths return a real 404. Markdown 404 responses link agents back to the archive and machine-readable indexes.