Suche

Erstellen Sie Ihre eigene App mit der ClickUp API

Möchten Sie eine App erstellen, die sich in ClickUp integriert? Gib deinen Benutzern die Fähigkeit, sich mit OAuth 2.0 anzumelden! 
Schauen Sie sich auch unsere API-Dokumentation an!

Was du wissen musst

OAuth 2-Fluss

Wenn Sie eine Anwendung entwickeln möchten, die andere nutzen können, müssen Sie einen OAuth2-Authentifizierungsfluss verwenden.
Mit OAuth 2 erhält jeder, der deine App nutzt, ein individuelles Token zugewiesen. Jeder Benutzer kann nur auf die Inhalte zugreifen, die in seinem ClickUp-Benutzerkonto verfügbar sind.

Wenn du nicht mit OAuth2 vertraut bist, hat Digital Ocean eine Anleitung zusammengestellt, um dir den Start zu erleichtern. Auf der Website von OAuth findest du zudem weitere Informationen.

Eine App erstellen

Der erste Schritt zur Nutzung von OAuth 2 ist das Erstellen einer App in deinem Workspace. Du musst ein Workspace-Eigentümer oder Administrator sein, um die Einstellungen für die Integration zu verwalten.
Um eine App in deinem Workspace zu erstellen:
  1. Klicke in der oberen linken Ecke auf deinen Workspace-Avatar.
  2. Wähle Einstellungen aus. 
  3. Wähle in der Seitenleiste „Alle Einstellungen“ ClickUp API aus.
  4. Klicke in der oberen rechten Ecke der ClickUp API-Einstellungsseite auf App erstellen.Screenshot der Schaltfläche „App erstellen“.png
  5. Gib den Namen deiner App und eine oder mehrere Weiterleitungs-URLs ein.
    Wenn du dir nicht sicher bist, welche Weiterleitungs-URL du verwenden sollst, schau dir den Leitfaden zu Weiterleitungs-URLs auf der OAuth-Website an.
  6. Klicken Sie auf App erstellen.
  7. Auf dem nächsten Bildschirm siehst du, dass eine Client-ID und ein Client Secret generiert wurden.
  8. Verwenden Sie die Client-ID und das Client-Geheimnis in Ihrer App, um einen OAuth 2-Authentifizierungsfluss zu erstellen.

Screenshot des App-modales Fensters, das OAuth2 verwendet.

Aktualisieren Sie Ihre Umleitungs-URLs

Wenn du eine neue Weiterleitungs-URL hast, kannst du diese Einstellungen in deinem ClickUp-Workspace jederzeit aktualisieren:
  1. Klicke in der oberen linken Ecke auf deinen Workspace-Avatar.
  2. Wähle Einstellungen aus. 
  3. Wähle in der Seitenleiste „Alle Einstellungen“ ClickUp API aus.
  4. Klicke auf eine vorhandene App, um ihre Details anzuzeigen.
  5. Aktualisiere die Weiterleitungs-URL.
  6. Klicke auf Speichern.

Client-Geheimnis anzeigen oder regenerieren

So generierst du dein Client-Geheimnis neu:
  1. Klicke in der oberen linken Ecke auf deinen Workspace-Avatar.
  2. Wähle Einstellungen aus. 
  3. Wähle in der Seitenleiste „Alle Einstellungen“ ClickUp API aus.
  4. Klicke auf eine vorhandene App, um ihre Details anzuzeigen.
  5. Klicke auf Anzeigen, um dein aktuelles Client-Geheimnis anzuzeigen.
  6. Klicke auf Erneut generieren, um ein neues Client-Geheimnis zu erstellen.
  7. Aktualisiere deine App, um das neue Client-Geheimnis zu verwenden.

Typen von Autorisierungstoken

Tokens ermöglichen es Ihnen, API-Aufrufe zu tätigen und sich mit anderen Anwendungen zu integrieren. Sie können auch Apps wie Make verwenden, um Integrationen ohne Programmierung zu erstellen. Token sind spezifisch für Ihr ClickUp-Benutzerkonto.
Jeder mit einem ClickUp-Konto kann einen persönlichen Token generieren. Persönliche Tokens gewähren Zugriff auf jeden Workspace, den Ihr Konto erstellt oder beitreten ist. Ihr persönliches Token gibt Ihnen denselben Zugriff, den Sie über einen Webbrowser haben.
Wenn Sie OAuth2 verwenden, können Sie beim ersten Authentifizieren oder später beim erneuten Authentifizieren wählen, ob Sie den Zugriff auf bestimmte Workspaces autorisieren möchten.
Screenshot von jemandem, der auswählt, welche Workspaces mit OAuth2 autorisiert werden sollen.