Die neue API-Dokumentation von 1Tool: schnell, übersichtlich und bereit für KI

Wer 1Tool mit einem anderen Programm verbinden will – mit einem Webshop, einer Buchhaltung, einem Lager oder einer eigenen App –, braucht eine gute Beschreibung der Schnittstelle. Die 1Tool-API ist dafür sehr umfangreich: Fast 3.000 API-Routen decken Kontakte, Angebote, Rechnungen, Projekte, Termine, Zeiterfassung und vieles mehr ab.

Mit der neuen API-Dokumentation finden Sie sich darin in wenigen Minuten zurecht – egal ob Sie selbst programmieren, eine Agentur beauftragen oder eine KI wie Claude oder ChatGPT mit 1Tool arbeiten lassen.

Was neu ist und wie Sie die Dokumentation nutzen, zeigt das Video in rund eineinhalb Minuten:

Die Vorteile auf einen Blick

• Nach Fachbereichen geordnet. Links finden Sie 14 Bereiche wie Kontakte, Vertrieb, Finanzen oder Projekte und Aufgaben. Darin stehen die Ressourcen – zum Beispiel Rechnungen – und darunter jede einzelne API-Route.
• In unter einer Sekunde geladen. Die Startseite ist sofort da. Öffnen Sie einen Bereich, lädt die Seite genau diesen Teil nach.
• Schnelle Suche mit Strg oder ⌘ K. Sie findet jede API-Route nach Name, Pfad oder Fachbegriff – auch auf Deutsch, etwa „Rechnung“ oder „Kontakt“. Mehr dazu weiter unten.
• Code-Beispiele zum Kopieren. Zu jeder API-Route gibt es ein fertiges Beispiel, etwa für cURL, PHP, JavaScript oder Python. Mit Ihrem eigenen Zugang können Sie API-Routen direkt in der Dokumentation ausprobieren.
• Direkt-Links auf jede API-Route. Jede API-Route hat eine eigene Adresse. So können Sie oder unser Support genau die Stelle weitergeben, um die es geht.
• Deutsch und Englisch. Die Oberfläche, die Bereiche und die Einführung gibt es in beiden Sprachen – umschaltbar mit einem Klick auf die Flagge.
• Erste Schritte und klare Regeln. Eine Einführung erklärt Anmeldung, Blättern durch Listen, Filter, Sortierung, Datumsangaben und eigene Felder.

Jede API-Route in Sekunden finden: die Suche

Bei fast 3.000 API-Routen ist die Suche das wichtigste Werkzeug. Sie öffnen sie jederzeit mit Strg + K (am Mac ⌘ + K) und tippen einfach los – die Treffer erscheinen sofort, ohne Wartezeit.

• Mit Ihren eigenen Worten. Die Suche kennt die Namen der Bereiche und Ressourcen auf Deutsch und Englisch. „Rechnung“ findet die API-Routen für Rechnungen genauso wie „invoice“.
• Mehrere Begriffe kombinieren. „Rechnung Mail“ zeigt genau die API-Routen, die zu beiden Wörtern passen – den Versand einer Rechnung per E-Mail und die Vorschau dieser E-Mail.
• Nach Pfad oder Namen. Wer schon einen Pfad wie /v1/contacts oder einen Namen wie contacts.list kennt, landet mit wenigen Buchstaben direkt dort.
• Ganz ohne Maus. Mit den Pfeiltasten wählen Sie einen Treffer, mit der Eingabetaste springen Sie direkt zur API-Route.

So nutzen Sie die API-Dokumentation in 4 Schritten

1. Dokumentation öffnen. Sie finden sie unter api.1tool.cloud/v1/docs. Für Deutsch klicken Sie oben links auf die deutsche Flagge.
2. Erste Schritte lesen. Dort steht, wie Sie einen Zugang erhalten und Ihre erste Anfrage an die API senden – mit einem Beispiel, das Sie nur noch anpassen müssen. Für dauerhafte Anbindungen empfehlen wir einen eigenen Benutzer mit genau den Rechten, die die Anbindung braucht.
3. Die richtige API-Route finden. Wählen Sie links den Bereich und die Ressource oder suchen Sie direkt. Zu jeder API-Route sehen Sie, welche Angaben sie erwartet und was sie zurückgibt.
4. Code übernehmen oder ausprobieren. Kopieren Sie das Beispiel in Ihr Programm oder testen Sie die API-Route direkt in der Dokumentation.

Bereit für Claude, ChatGPT und andere KI-Systeme

Immer mehr Unternehmen lassen KI-Assistenten Aufgaben in ihren Programmen erledigen: Kontakte anlegen, offene Rechnungen auswerten, Termine eintragen. Damit das zuverlässig klappt, muss die KI die Schnittstelle verstehen. Genau dafür ist die neue Dokumentation gebaut:

• Kleine Dateien statt einer großen. Für jede Ressource gibt es eine eigene Beschreibung im OpenAPI-Format. Eine KI lädt nur den Teil, den sie gerade braucht.
• llms.txt. Diese Übersichtsdatei sagt KI-Systemen, welche Bereiche es gibt und wo sie die passende Beschreibung finden.
• Feste Namen für jede API-Route. Jede API-Route hat einen eindeutigen Namen wie invoices.send oder contacts.list, über den eine KI sie sicher ansprechen kann.
• Direkt mit Claude und ChatGPT. Über den 1Tool-Connector arbeiten KI-Assistenten direkt mit Ihren 1Tool-Daten – mit denselben Rechten, die der jeweilige Benutzer auch in 1Tool hat. Mehr dazu auf unserer Seite zur KI-Integration.

Was bleibt gleich?

Die Schnittstelle selbst ändert sich nicht: Alle bestehenden Anbindungen laufen unverändert weiter. Für neue Anbindungen empfehlen wir die Adresse https://api.1tool.cloud/v1 – sie ist zusätzlich durch eine Web Application Firewall geschützt. Neu ist, wie sie beschrieben ist. Die gewohnte Swagger-Ansicht finden Sie weiterhin über den Link Bisherige Ansicht (Swagger) oben links.

Sie planen eine Anbindung an 1Tool oder möchten einen KI-Assistenten mit Ihren Daten verbinden? Sprechen Sie uns an – wir helfen Ihnen gern beim Einstieg.