Zum Inhalt springen

API (Programmierschnittstelle)

Zuletzt aktualisiert:

Was eine API ist

Eine API ist ein Vertrag zwischen zwei Systemen. Sie legt fest, was man anfragen kann, wie die Anfrage aussehen muss und was zurückkommt. Das System, das die API anbietet, entscheidet, was es freigibt: Ein Onlineshop lässt Partner zum Beispiel Produkte und Preise lesen, aber nicht ändern. Das Programm auf der anderen Seite sieht nie den internen Code oder die Datenbank, sondern nur die Antworten der API.

Die meisten APIs im Web folgen dem REST-Stil. Jede Art von Ressource, etwa Produkte oder Bestellungen, hat eine eigene Adresse, den sogenannten Endpunkt, und Standard-HTTP-Methoden beschreiben die Aktion: GET liest Daten, POST legt etwas an, PUT oder PATCH ändert es und DELETE löscht es.

So funktioniert es

Ein typischer API-Aufruf besteht aus diesen Teilen:

  • Endpunkt: die URL, die die Ressource bezeichnet, zum Beispiel die Adresse einer Produktsuche.
  • Methode: das HTTP-Verb, etwa GET zum Lesen oder POST zum Senden von Daten.
  • Authentifizierung: der Nachweis, dass der Aufrufer berechtigt ist, etwa ein API-Schlüssel, ein Bearer-Token oder ein OAuth-Zugriffstoken, meist im Header übertragen.
  • Daten und Antwort: der Inhalt der Anfrage und die zurückgelieferten Daten, meist im JSON-Format, dazu ein Statuscode wie 200 für Erfolg oder 404 für „nicht gefunden“.
  • Limits: Die meisten Anbieter begrenzen die Zahl der Anfragen pro Minute oder pro Tag. Diese Grenzen heißen Rate Limits.

Beispiel

Eine Kundin fragt den Chatbot eines Möbelhauses, ob ein Sofa in Grau vorrätig ist. Der Chatbot schickt eine GET-Anfrage mit Produktname und Farbe an die Lager-API des Händlers. Die API antwortet im JSON-Format mit Bestand und Lieferzeit, und der Chatbot antwortet mit diesen aktuellen Angaben, statt eine veraltete Produktseite zu zitieren.

Warum das für Business-Chatbots wichtig ist

Ein Chatbot, der mit Dokumenten trainiert wurde, kennt den Stand vom Zeitpunkt, an dem die Inhalte hinzugefügt wurden. Über APIs kommt er an Daten, die sich ändern: Lagerbestand, Preise, freie Termine oder Kontodaten. Sprachmodelle erreichen APIs über Tool Calling: Das Modell fordert einen Aufruf an, und die Anwendung führt ihn aus.

Weil die Anwendung die Zugangsdaten hält, bestimmt sie, welche Endpunkte der Chatbot nutzen darf und welche Daten das Modell sieht. Lesender Zugriff, enge Berechtigungen und Zugangsdaten auf dem Server halten das Risiko klein, auch das Risiko, dass eine manipulierte Nachricht einen unerwünschten Aufruf auslöst. Dieses Risiko heißt Prompt Injection.

APIs und intoCHAT

intoCHAT arbeitet mit APIs in beide Richtungen. Ab dem Starter-Plan lässt die REST-API deinen eigenen Server mit deinen Agenten chatten und Gespräche, Leads und Wissensquellen lesen, mit API-Schlüsseln des Kontos, die sich auf Scopes beschränken lassen und je bis zu 60 Anfragen pro Minute stellen. In die andere Richtung kann dein Agent deine APIs aufrufen:

  • Mit eigenen API-Aktionen ruft der Agent während eines Chats deine HTTP-API auf, mit beliebiger Methode und Authentifizierung per Bearer-Token, Basic Auth, API-Schlüssel im Header oder in der Query oder eigenen Headern.
  • Du kannst eine Anfrage aus einem cURL-Befehl importieren, Eingaben festlegen, die der Agent aus dem Gespräch füllt, JSON-Daten senden, auswählen, welche Antwortfelder das Modell sieht, und jede Aktion vor dem Livegang testen. Bis zu 25 Aktionen pro Agent.
  • „Shop verbinden“ erstellt aus den öffentlichen Daten eines Shops Live-Aktionen für die Produktsuche, ohne API-Schlüssel oder App-Installation.
  • Leads erhältst du per E-Mail-Benachrichtigung zu jedem neuen Lead an den Inhaber und bis zu 5 weitere Adressen sowie über den CSV-Export in der Lead-Tabelle.

Häufige Fragen

Wofür steht API?

API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. Gemeint sind die Regeln, nach denen ein Programm Daten oder Aktionen von einem anderen anfordert. Im Web heißt das meist: HTTP-Anfragen senden und JSON-Antworten empfangen.

Was ist der Unterschied zwischen einer API und einem Webhook?

Bei einer API fragt dein Programm Daten ab, wenn es sie braucht. Bei einem Webhook schickt das andere System die Daten von sich aus an dein Programm, sobald ein Ereignis eintritt, etwa eine neue Bestellung. Viele Dienste bieten beides an.

Kann ein Chatbot die API meines Unternehmens nutzen?

Ja, wenn die Chatbot-Plattform Tool Calling oder API-Aktionen unterstützt. Du beschreibst den Endpunkt und seine Eingaben, der Chatbot füllt sie aus dem Gespräch, und die Plattform führt den Aufruf mit deinen Zugangsdaten aus. Bei intoCHAT geht das mit eigenen API-Aktionen, bis zu 25 pro Agent.

Hat intoCHAT eine öffentliche API?

Ja, ab dem Starter-Plan. Mit der REST-API von intoCHAT sendet dein Server einem Agenten eine Nachricht und erhält seine Antwort, listet Agenten auf, liest Gespräche und Leads und fügt Wissensquellen hinzu oder löscht sie, mit API-Schlüsseln, die sich auf Scopes beschränken lassen, und bis zu 60 Anfragen pro Minute je Schlüssel. Jede Antwort über die API zählt als eine Nachricht deines Plans. Außerdem kann dein Agent über eigene API-Aktionen deine APIs aufrufen, und signierte Webhooks senden neue Leads und weitere Ereignisse an eine Adresse deiner Wahl.

Sieh, wie er mit deiner Website antwortet

Gib die Adresse deiner Website ein und chatte mit einem Agenten, der aus deinen Seiten gebaut wird. Das dauert etwa eine Minute.

Agent kostenlos erstellen

Kostenloser Plan, keine Kreditkarte nötig.