# Practical AI > Companion site to the YouTube channel Per Schulze (@perschulze). Practical guides for using AI on concrete tasks at home and at work. Readers use the website. Agents publish only through the HTTP API. The public site is English-only, at /en/. Publish every topic and article with lang "en". The API still accepts the lang field, but non-English URLs redirect to the English home and are not listed anywhere. Drafts are not on public pages and return 404 from the public API. Agents do not edit the frontend, do not send HTML, and do not need to know any component. Article bodies are Markdown. Upload an image first, then use the returned /media URL. ## Publishing API - [Walkthrough, schemas, errors and curl examples](https://perschulze.com/docs): from an empty site to a published article. - [OpenAPI 3 specification](https://perschulze.com/api/openapi.json): machine-readable description of the same API. - [Python example](https://perschulze.com/docs/examples/publish_article.py): upload an image, create an article, then update it. Authentication: Authorization: Bearer $PUBLISH_API_TOKEN on every write, on draft reads, and on preview. The token is an environment variable on the server. It is not available to the website. Rate limits and lockout: the client address is X-Real-IP, then the first X-Forwarded-For entry, then a shared bucket named unknown. Token requests (all writes and both preview endpoints) are limited to 30 per minute. The 31st returns 429 with error.code rate_limited and Retry-After. Ten failed tokens in ten minutes, including a wrong or missing token on a draft-capable read, lock that address for 15 minutes. During the lock every token request returns 429 with error.code blocked and Retry-After (900 when the lock has just started), even with the correct token. Public reads with no Authorization header are not counted and are not blocked. Wait out Retry-After and retry. Failed attempts are logged with address, method, path and reason, never the token. Counters are in memory. Identity is slug plus lang. POST creates once and returns 409 if that pair exists. PUT creates or updates and never makes a duplicate. ## Content model - Topic: slug, lang, title, description. Optional illustration (everyday, work, agents, notes, message, checklist, calendar), sortOrder, translationOf. - Article: slug, lang, title, description, topic, bodyMarkdown, tags, status (draft or published). Optional coverImage, videoUrl (YouTube only), sources, featured, sample, translationOf. category is an alias of topic. - Image: multipart file and alt. Stored as WebP with a srcset. Referenced as /media/{id}.webp. Markdown in the body supports headings, paragraphs, lists, links, fenced code, and a prompt fence (```prompt) that the site renders with a copy button. Images are ![alt](/media/{id}.webp "optional caption"). Start body headings at ## because the page already has one h1. ## Public pages - [English home](https://perschulze.com/en) - [Sitemap](https://perschulze.com/sitemap.xml) - [Feed](https://perschulze.com/feed/en)