Aber sicher! Unsere API ist auf GraphQL aufgebaut und gibt dir eine Menge Flexibilität für den Zugriff und die Änderung von Informationen in deinem monday.com Konto.

 

 

Warum GraphQL?

Unsere Anwender nutzen monday.com, um alle möglichen Informationen zu verwalten, und wir wollten eine API bauen, die genauso flexibel ist wie unsere Plattform. Deshalb haben wir eine API entwickelt, die aussagekräftige Anfragen verarbeiten kann, um genau die Informationen zu erhalten, die du brauchst, wenn du sie brauchst. Wenn du mehr über GraphQL als Anfragensprache wissen möchtest, sieh dir graphql.org an. 😄 

 

Dokumentation und Tests

Um die Verwendung unserer API zu vereinfachen, haben wir eine Dokumentation geschrieben, die die Anfragen und Mutationen erklärt, die du an deinen Daten vornehmen kannst. Du kannst deine Anfragen auch hier in unserem GraphQL-Explorer testen. 

 

Authentifizierung mit deinem API-Token

Jegliche Anfrage an unsere API muss von einem API-Token begleitet werden, damit wir wissen, dass du es bist. 😊

 

API für Admin-Benutzer

Jeder Administrator des Kontos hat sein eigenes API-Token. Achte darauf, dass es stets sicher ist! So erzeugst du dein API-Token: 

1. Melden dich bei deinem monday.com-Konto an.
2. Klicke in der oberen rechten Ecke auf deinen Avatar.
3. Wähle die „Administration“ aus.
4. Klicke auf der linken Seite der Adminseite auf „Verbindungen“. 
5. Wähle „API“ im oberen Menü aus. 
6. Klicke auf die Schaltfläche „Kopieren“ oben rechts vom persönlichen API-Token. So sollte es aussehen:

 

API für Nicht-Admin-Benutzer

Wenn du kein Administrator deines monday.com-Kontos bist, kannst du deine API-Tokens über den Entwicklerbereich erhalten, indem du diesen Schritten folgst: 

1. Melden dich bei deinem monday.com-Konto an.
2. Klicke in der oberen rechten Ecke auf deinen Avatar.
3. Wähle einen „Entwickler“ aus.
4. Klicke oben auf „Entwickler/in“ und dann auf „Meine Zugangstoken“. 
5. Wähle neben dem API-Token „Anzeigen“ aus, und dann kannst du es auch kopieren. 

Du kannst diesen API-Token verwenden, um all deine Anfragen an unsere API sowie in unserer Testumgebung zu authentifizieren. Der Token kann jederzeit neu generiert werden. Beachte aber, dass dadurch der alte Token ungültig wird. 

 

API-Token, die über OAuth generiert wurden

Du kannst auch ein Token für bestimmte Apps erzeugen, indem du den OAuth-Autorisierungsflow verwendest. Die Berechtigungen dieser Token sind basierend auf den Autorisierungsbereichen der App, mit der sie verknüpft sind, begrenzt. Weitere Informationen findest du in unserer OAuth-Dokumentation.

 

API-Token-Berechtigungen

Das API-Token eines jeden Benutzers wird in Bezug auf die Berechtigungen dieses Benutzers betrachtet. 

Wenn der Benutzer z. B. nur Lesezugriff auf ein bestimmtes Board hat, kann das API-Token keine Informationen auf diesem Board aktualisieren. 

Ähnlich verhält es sich, wenn ein Benutzer keinen Zugriff auf ein privates Board hat - alle Apps, die das API-Token verwenden, haben auch keinen Zugriff auf dieses Board. 

 

Zugriff auf unsere GraphQL-API

Wir wissen, dass unsere Benutzer gerne Dinge ausprobieren, bevor sie sie implementieren, deshalb haben wir einen Anfrage-Editor direkt in unsere Plattform integriert! Damit kannst du Anfragen und Mutationen ausprobieren, bevor du sie in deiner Anwendung implementierst .Um den API-Explorer zu verwenden, gehe auf diesen Link.

Wenn du die Explorer-Seite geöffnet hast, gib den API-Token in dieses Feld ein: 

Nachdem du deinen Token eingegeben hast, gelangst du in unsere Testumgebung. Im linken Bereich des Explorers gibst du die Anfrage oder Mutation ein, und wenn du oben links auf „Play“ drückst, enthält der rechte Bereich deine Ergebnisse. 

Du kannst auch auf die Schaltfläche „Dokumente“ oben rechts klicken, um direkt über den Explorer auf unsere Dokumentation zuzugreifen. Um außerhalb des Explorers auf unsere Dokumentation zuzugreifen, klicke auf diesen Link!

 

Anfragen senden

Du hast also deine Anfragen getestet und möchtest diese direkt von deiner Anwendung aus versenden? Dann bist du hier an der richtigen Stelle! 😊

Alle Anfragen an unseren Server sollten POST-Anfragen sein, die an api.monday.com/v2 gesendet werden. 

Stelle sicher, dass du den Inhaltstyp application/json verwendest und deinen API-Schlüssel als „Authorization“-Parameter in den Headern übergibst:

{
    "Content-Type" : "application/json",
    "Authorization" : "mySuperSecretAPIKey"
}

Der Anfragekörper ist der Ort, an dem deine Anfrage und Variablen übergeben werden. Dies sollte folgendermaßen aussehen:

{ 
    "query" : "...",
    "variables" : {"myVariable" : "foo", "yourVariable" : "bar"}
}  

 

Postman-Sammlung

Wir haben Beispiele für die häufigsten API-Anfragen (Programmierschnittstelle) in einer Postman-Sammlung zusammengestellt. Damit kannst du Musteranfragen mit unserer API testen und Code-Snippets generieren, die du in deine Anwendung kopieren kannst. Sieh dir die Beispiele an, damit du deine eigenen Anfragen testen kannst.

Warum die API verwenden?

Du bist dir nicht sicher, ob du die API nutzen sollst oder nicht? Mit der API können benutzerdefinierte Anwendungen auf das monday work OS zugreifen, sodass du deine eigenen Skripte, Integrationen und Tools mit deinen Workflows verbinden kannst. Wenn das nach etwas klingt, das dich interessiert, dann ist die API genau das Richtige für dich.

Du kannst die API auf viele Arten nutzen, um deine Workflows zu optimieren. Hier sind einige Beispiele:

• Verbindung mit Datenintegrationen von Drittanbietern
• Konfiguration von No-Code-Integrationstools wie Zapier, um eigene Datenflüsse zu erstellen
• Importieren und Exportieren von Datensätzen
• Nutzung der API als Datenschicht für benutzerdefinierte monday Apps zur Verknüpfung mit monday

Wie du noch einen Schritt weiter gehst

Die Plattform von monday enthält auch Tools, mit denen du Anwendungen erstellen kannst, die in deine Workflows eingebettet sind – z. B. Board-Ansichten für Apps, Integrationen und mehr.

Wenn du noch mehr Möglichkeiten brauchst, um deine Workflows zu verbessern, kannst du das monday Apps Framework nutzen, um maßgeschneiderte Anwendungen für bestimmte Anforderungen innerhalb deines Arbeitsbereichs zu erstellen. Erfahre mehr in unserer Apps Framework-Dokumentation und stöbere in unseren Beispielen.

Ratenlimits

Die API-Ratengrenzen basieren auf der Komplexitätsstufe, die auf 10.000.000 / Minute pro Konto begrenzt ist. Mehr darüber erfährst du hier!

 

Frohes Codieren!

Nachdem du nun ein grundlegendes Verständnis für das Senden von Anfragen an unsere API hast, schaue dir unsere API-Dokumentation hier an. Du kannst auch mit unserer Testumgebung herumspielen!

Und last but not least, schaue dir unsere Schnellstart-Tutorials für verschiedene Programmiersprachen an:

• API Quickstart Tutorial - Javascript
• API Quickstart Tutorial - PHP
• API Quickstart Tutorial - Python

 

 

 

Wenn du Fragen hast, wende dich einfach hier an unser Team. Wir sind rund um die Uhr erreichbar und helfen gerne!