Eine Schnittstelle. Klarer Umfang.
Pharen API
Bindet definierte Workspace-Daten, Workflows und Agenten-Schritte in bestehende Anwendungen ein. Endpunkte, Rechte und Betrieb richten sich nach eurem Pharen-Setup.
Die API folgt eurem Pharen-Setup.
Cloud oder Self-hosted, Authentifizierung, Datenbereiche und Limits werden vor dem produktiven Einsatz verbindlich festgelegt.
| Betrieb und Kontrolle | API-Bausteine | API |
|---|---|---|
| Authentifizierung | Tokens, Rollen und Gültigkeit begrenzen den Zugriff auf den vereinbarten Anwendungsfall. | |
| Datenumfang | Endpunkte liefern nur die Felder und Workspace-Bereiche, die die Integration benötigt. | |
| Beobachtbarkeit | Anfragen, Workflow-Status und Fehlerpfade bleiben im technischen Betrieb nachvollziehbar. | |
| Support und Limits | Rate Limits, Verfügbarkeit und Supportumfang werden passend zum Betrieb dokumentiert. |
So sieht ein konkreter Ablauf aus
Kundendaten aus dem ERP synchronisieren, ohne doppelte Pflege.
Ein Großhändler mit 90 Mitarbeitenden führt Kunden und Aufträge im ERP. Der Vertrieb will Anfragen und Vorgänge in Pharen Hub bearbeiten, ohne Kundendaten ein zweites Mal zu pflegen oder abzutippen.
- Im Setup wird festgelegt, welche Felder aus dem ERP in die Liste Kunden dürfen: Kundennummer, Name, Ansprechperson, Zahlungsziel. Alles andere bleibt im ERP.
- Ein Integrationsdienst auf eurer Seite ruft nachts die geänderten Kunden ab und legt sie über den Endpunkt Workspace Context als Datensätze an oder aktualisiert sie.
- Der Zugriff läuft über ein Token mit einer Rolle, die nur diese Liste schreiben darf. Andere Bereiche des Workspaces sind für die Integration nicht sichtbar.
- Ändert sich im ERP das Zahlungsziel eines Kunden, sendet das ERP einen Webhook. Der Datensatz in Pharen Hub wird aktualisiert, und offene Vorgänge zu diesem Kunden erhalten einen Hinweis.
- Wird in Pharen Hub ein Auftrag als freigegeben markiert, startet ein Workflow-Lauf über die API, der die geprüften Auftragsdaten an das ERP zurückgibt.
- Anfragen, Statuscodes und Fehlerpfade bleiben im technischen Betrieb nachvollziehbar, damit eine fehlgeschlagene Synchronisation auffällt, bevor jemand mit veralteten Daten arbeitet.
Der Vertrieb arbeitet mit aktuellen Kundendaten im Workspace, die Buchhaltung bleibt im ERP führend. Die Integration liest und schreibt genau die Felder, die vorher vereinbart wurden, und nichts darüber hinaus.
Was dazugehört
Die API ist ein Datenweg, kein eigenes Modul. Diese Module sind auf der Pharen-Seite beteiligt, und diese Systeme stehen typischerweise auf der anderen Seite.
Module in Pharen Hub
- Lists Datensätze in Lists sind das häufigste Ziel für gelesene oder geschriebene Daten aus anderen Anwendungen.
- Workflows Workflow-Läufe lassen sich mit validierten Eingaben starten und ihr Status abfragen.
- Agents Begrenzte Agentenaufgaben können angestoßen werden, wenn Ziel, Quellen und Freigabepunkt definiert sind.
Externe Systeme
- CRM und ERP Kunden-, Auftrags- und Stammdaten aus Bestandssystemen, nach technischer Prüfung des Datenwegs.
- Webhooks Ereignisse aus anderen Systemen, die in Pharen Hub einen Datensatz aktualisieren oder einen Schritt auslösen sollen.
- MCP Server Wenn ein Agent nur lesend auf ein System zugreifen soll, ist MCP oft der einfachere Weg als eine eigene Integration.
Häufige Fragen
Wie wird der Zugriff authentifiziert?
Über Tokens, die an eine Rolle im Workspace gebunden sind. Ein Token sieht und schreibt nur die Bereiche, die diese Rolle freigibt. Gültigkeit, Rotation und Widerruf werden im Setup festgelegt, damit ein verlorenes Token keinen Vollzugriff bedeutet.
Gibt es Rate Limits und was passiert bei Überschreitung?
Ja, Rate Limits werden passend zum Betrieb dokumentiert. Bei Überschreitung antwortet die API mit einem klaren Statuscode statt Daten stillschweigend zu verwerfen. Für Massensynchronisationen empfehlen wir Batch-Läufe außerhalb der Arbeitszeit.
Bleibt die Integration bei Pharen-Updates stabil?
Endpunkte sind versioniert. Änderungen, die bestehende Aufrufe brechen würden, kommen als neue Version und werden angekündigt, damit euer Integrationsdienst Zeit für die Umstellung hat. Self-hosted Setups steuern den Update-Zeitpunkt zusätzlich selbst.
Wann die API nicht der richtige Weg ist
Eine eigene Integration lohnt sich, wenn ein System spezifische Felder lesen oder schreiben und Workflows auslösen muss. Für Microsoft 365, Google Workspace oder ein Postfach gibt es bereits einen Weg im Workspace, und für lesenden Zugriff durch Agents reicht oft ein MCP Server. Prüft zuerst die vorhandenen Integrationen, bevor ihr Code schreibt.
Integrationen ansehenDer genaue Vertrag entsteht aus dem Setup.
Die KI-Plattform für Unternehmen, in 13 Modulen.
Vom Team-Chat bis zur Freigabe bleibt die Arbeit am selben Vorgang. Status und nächster Schritt sind jederzeit sichtbar.
Chat
Antworten aus euren Docs, Mails und Projekten, nicht aus dem Internet.
Workflows
Rechnungsprüfung oder Onboarding: jeder Schritt hat eine Freigabe.
Agents
Ein Agent recherchiert, ein Mensch gibt frei. Die Grenzen setzt ihr.
Projects
Bündelt Ziele, Aufgaben, Entscheidungen und Fortschritt.
Lists
Bestellungen, Geräte oder Bewerber als Tabelle, Board oder Kalender.
Verbindet Nachrichten direkt mit der zugehörigen Arbeit.
Kalender
Koordiniert Termine, Vorbereitung und Follow-ups.
Meetings
Haltet Entscheidungen und nächste Schritte direkt im Kontext fest.
Channels
Haltet Teamgespräche bei Projekten und Entscheidungen.
Studio
Baut Apps, Tools, Seiten und Prototypen im Workspace.
Docs
Erstellt Dokumente dort, wo Wissen und Entscheidungen liegen.
Integrationen
Verbindet bestehende Systeme und Daten mit Pharen.
API
Bindet Daten, Aktionen und Agent-Läufe in eigene Apps ein.
Aktuelles Modul: 1 / 13
Bringt die Anwendung mit, die Pharen-Kontext braucht.
Wir klären Daten, Aktionen, Authentifizierung und Betrieb und entwerfen daraus den kleinsten sinnvollen API-Vertrag.