# OpenAPI, Postman und weitere Dateien

> Die maschinenlesbare Beschreibung der API, die Postman-Collection, llms.txt und die Markdown-Version jeder Seite.

Stand: 2026-10-30. Quelle: https://docs.smartchat.marketing/de/api/openapi/

| Datei | Was es ist |
|---|---|
| [openapi.json](https://docs.smartchat.marketing/openapi.json) | Die OpenAPI-3.1-Beschreibung der API. Das ist die eine Quelle; die Referenz wird aus denselben Daten erzeugt. |
| [openapi.yaml](https://docs.smartchat.marketing/openapi.yaml) | Dasselbe als YAML. |
| [postman-collection.json](https://docs.smartchat.marketing/postman-collection.json) | Eine Postman-Collection mit einer Anfrage pro Aufruf. Setze die Variable `api_key`. |
| [llms.txt](https://docs.smartchat.marketing/llms.txt) | Eine Liste aller Seiten für AI-Assistenten. |
| [llms-full.txt](https://docs.smartchat.marketing/llms-full.txt) | Alle Seiten in einer Datei. |
| [smartchat-docs.zip](https://docs.smartchat.marketing/smartchat-docs.zip) | Alle Seiten als Markdown plus die OpenAPI-Dateien. |
| [sitemap.xml](https://docs.smartchat.marketing/sitemap.xml) | Alle Seiten. |

Jede Seite gibt es auch als Markdown: Hänge `.md` an ihre Adresse an oder nutze den Link am Ende der Seite.

## Mit OpenAPI einen Client erzeugen

Jeder OpenAPI-3.1-Generator kann aus `openapi.json` einen Client erzeugen. Jeder Aufruf hat eine `operationId`, die dem Namen in dieser Referenz entspricht. Der MCP-Server nutzt für die meisten Werkzeuge denselben Namen. Wo er abweicht (zum Beispiel `save_contact` für `create_contact` und `update_contact`), steht der Name in `x-mcp-tool` und in der Spalte **REST operationId** der [Werkzeugliste](https://docs.smartchat.marketing/de/mcp/tools/). Zusätzliche Felder mit `x-` beschreiben das Recht (`x-scope`), das Risiko (`x-risk`), die Wirkungen (`x-effects`) und das MCP-Werkzeug (`x-mcp-tool`).