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 Ihre App verwendet, ein individualisiertes Token. Jeder Benutzer kann nur auf die Inhalte zugreifen, die seinem individuellen ClickUp-Benutzerkonto zur Verfügung stehen.

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 Verwendung von OAuth 2 besteht darin, eine App in Ihrem Workspace zu erstellen. Sie müssen Eigentümer oder Administrator eines Workspaces sein, um Integrationseinstellungen verwalten zu können. Um dies zu tun:
  1. Klicke in der oberen rechten Ecke auf deinen persönlichen Avatar.
  2. Wähle Einstellungen aus. 
  3. Wähle in der Seitenleiste Apps aus.
  4. Klicke auf + Neue App erstellen.
  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 sehen Sie, dass eine Client-ID und ein Client-Geheimnis 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 rechten Ecke auf deinen persönlichen Avatar.
  2. Wähle Einstellungen aus. 
  3. Wähle in der Seitenleiste Apps 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 rechten Ecke auf deinen persönlichen Avatar.
  2. Wähle Einstellungen aus. 
  3. Wähle in der Seitenleiste Apps 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.

War dieser Beitrag hilfreich?