> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-de/kilo-iot-server/api.md). # API Überblick über die API des Kilo IoT Server — REST- und gRPC-Zugriff, bereichsbezogene Schlüssel sowie Cloud- oder On-Premise-Integrationsendpunkte. Die Kilo-IoT-Plattform bietet programmatischen Zugriff, sodass externe Systeme die Daten und Konfiguration Ihrer Bereitstellung lesen und verwalten können — und jetzt auch Befehle an Ihre Geräte senden können — und deckt dabei Backend-Integrationen, Analyse- und Reporting-Pipelines, Industrie- und Automatisierungstools sowie benutzerdefinierte Anwendungen ab. Verwenden Sie die [**API-Referenz**](https://api.kiloiot.io/) für die vollständige Liste der Endpunkte, Anfragefelder, Antworten und erforderlichen Scopes. Dieser Abschnitt behandelt, wofür die API gedacht ist, wie ein Protokoll ausgewählt wird, wie sich Anfragen authentifizieren und wo Schlüssel verwaltet werden. > Die Gerätesteuerung ist Teil der API: Ein Schlüssel mit dem **Befehle** Berechtigungsumfang kann die Befehle eines Geräts erstellen und sie als Downlinks senden (Ein/Aus, Sollwerte und dergleichen). Siehe [Gerätebefehle](/kilo-docs-de/kilo-iot-server/devices/commands.md) für den Workflow in der App und die [API-Referenz](https://api.kiloiot.io/#tag/commands) für die Befehlsendpunkte. ## Was verfügbar ist Am selben gesicherten Endpunkt werden zwei Protokolle angeboten: * **REST** — der primäre Weg für die meisten Integrationen. Standard-HTTPS und JSON, von jedem HTTP-Client aus nutzbar. Beginnen Sie hier, sofern Sie keinen besonderen Grund haben, dies nicht zu tun. Siehe [Öffentlichen REST-API](/kilo-docs-de/kilo-iot-server/api/public-rest-api.md). * **gRPC** — der erweiterte / On-Premise-Pfad. Wählen Sie REST, sofern Sie gRPC nicht ausdrücklich für eine On-Premise- oder typisierte Service-zu-Service-Integration benötigen. Siehe [gRPC-API](/kilo-docs-de/kilo-iot-server/api/grpc-api.md). Daneben dient ein separater Endpunkt KI-Clients statt des von Ihnen geschriebenen Codes: * **MCP** — verbinden Sie einen MCP-fähigen KI-Client wie Claude Code oder Claude Desktop mit Ihrer Organisation. Sie autorisieren ihn im Browser mit Ihrem üblichen Kilo-Konto, anstatt einen Schlüssel auszugeben, und er arbeitet innerhalb Ihrer eigenen Berechtigungen. Siehe [MCP-Server](/kilo-docs-de/kilo-iot-server/api/mcp-server.md). ## Authentifizierung Anfragen werden mit einem auf den entsprechenden Berechtigungsumfang beschränkten API-Schlüssel im `X-API-Key` Header authentifiziert (Format `kilo_`), plus Ihren Organisationskontext in `X-Organization-Id`. Schlüssel werden in erstellt und verwaltet **Einstellungen → API-Schlüssel**; die Konzepte werden zusammengefasst in [Authentifizierung & API-Schlüssel](/kilo-docs-de/kilo-iot-server/api/authentication-and-api-keys.md), und der vollständige Workflow zur Schlüsselverwaltung ist in [API-Schlüssel](/kilo-docs-de/kilo-iot-server/settings/api-keys.md). ## Cloud und On-Premise Cloud-Bereitstellungen verwenden den oben genannten verwalteten Endpunkt. On-Premise-Installationen stellen dieselbe API innerhalb Ihrer eigenen Netzwerkgrenze bereit, wo gRPC sich natürlich für interne Service-zu-Service-Automatisierung eignet — REST bleibt jedoch verfügbar und ist weiterhin der einfachste Ausgangspunkt. ## In diesem Abschnitt * [Öffentlichen REST-API](/kilo-docs-de/kilo-iot-server/api/public-rest-api.md) — der Standard-Integrationspfad. * [gRPC-API](/kilo-docs-de/kilo-iot-server/api/grpc-api.md) — der erweiterte / On-Premise-Pfad (typisiert, Service-zu-Service). * [MCP-Server](/kilo-docs-de/kilo-iot-server/api/mcp-server.md) — verbinden Sie Ihren eigenen KI-Client mit Ihrer Organisation. * [Authentifizierung & API-Schlüssel](/kilo-docs-de/kilo-iot-server/api/authentication-and-api-keys.md) — wie Anfragen autorisiert werden. * [Beispiele](/kilo-docs-de/kilo-iot-server/api/examples.md) — eine minimale authentifizierte Anfrage zum Einstieg. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.kiloiot.io/kilo-docs-de/kilo-iot-server/api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.