Joinpoints API V1

Joinpoints Developer

Joinpoints API (V1)

Die Joinpoints API ist die zentrale Business-API, um Inhalte in Joinpoints zu verwalten: Joinpoints erstellen, suchen, aktualisieren, Timeline-Posts anlegen und Beziehungen zwischen Joinpoints setzen. Alle verfügbaren Endpoints inkl. Parameter und Response-Modelle findest du direkt in der Swagger/OpenAPI-Ansicht unten.

Was du typischerweise mit der API machst

Joinpoints anlegen (z. B. Deal/Projekt/Kontakt)
Daten aktualisieren (Felder aus externen Systemen synchronisieren)
Timeline dokumentieren (Posts wie E-Mail, Call, Statusupdates)
Relationen verwalten (z. B. Joinpoints miteinander verknüpfen)
Workflows automatisieren (z. B. Aufgaben, Statuswechsel, Zuteilungen – abhängig vom Endpoint-Umfang)

Wichtige Konzepte

Joinpoint vs. Post

Joinpoint: ein „Hauptobjekt“ (z. B. Deal, Kontakt, Company, Task)
Post: ein Timeline-Eintrag innerhalb eines Joinpoints (z. B. E-Mail, Call, Notiz)

Templates & Felder

Viele Joinpoints basieren auf Templates (z. B. Pipeline/Liste). Welche Felder verfügbar sind und welche Datentypen erwartet werden, hängt vom Template ab. Genau diese Informationen liefert dir die Structure API.

Best Practice: Nutze die Structure API, um Template ID, Field IDs und Optionen zu laden, bevor du create oder update ausführst. So wird deine Integration robust gegen Template-Änderungen.

Datenqualität & Validierung

Halte dich an Datentypen (String/Number/Boolean/Relation) gemäß Template-Meta
Nutze saubere Fehlerbehandlung (z. B. bei 400 den Response-Body loggen)
Bei Relationsfeldern ggf. eigene Endpoints verwenden (siehe Hinweise in der Structure API)

Joinpoint API Commands

Die folgenden „API commands“ sind die technische Referenz: Endpoints, Parameter, Payloads, Response-Schemas und Beispiel-Requests. Wenn du Kontext brauchst (wie du an IDs kommst oder welche Reihenfolge sinnvoll ist), siehe Overview & Structure API.

Joinpoint Files API Commands

Die Joinpoints Files API besteht darin das interne File-System eines jeden Joinpoint zu nutzen. Dies dient vor allem um viele Dateien wie z.B. Fotos etc. in einer gewohnten Ordner-Struktur abzuspeichern. In der App findest du die Joinpoint Files bei dem Reiter "Dateien" in einem Projekt/Unternehmen/...