Konfigurowanie konta monday.com

Pierwszym krokiem jest zarejestrowanie się i utworzenie konta próbnego. Do tworzenia i testowania aplikacji lub integracji API użyj konta deweloperskiego (zarejestruj się). Jeśli masz już konto monday.com, przejdź do następnego kroku!

Włączanie trybu deweloperskiego

Tryb deweloperski (Developer mode) to przydatne narzędzie, które ułatwia programowanie w monday, udostępniając identyfikatory szablonów, kolumn, dokumentów i inne. Dzięki niemu możesz łatwo pobrać te identyfikatory, których wymaga wiele metod w naszym API. Aby go włączyć, wykonaj te kroki:

1. Kliknij swoje zdjęcie profilowe w prawym górnym rogu konta monday.
2. Wybierz monday.labs.
3. Wpisz Developer mode w pasku wyszukiwania.
4. Kliknij Aktywuj (Activate) i zamknij okno modalne.
5. Poczekaj, aż strona się odświeży.
6. Odśwież stronę i ponownie otwórz menu profilu.

Uwierzytelnianie w API

Po skonfigurowaniu konta monday.com musisz uwierzytelnić się za pomocą tokenu dostępu. Więcej informacji o tym, jak aplikacje powinny uwierzytelniać się w naszym API, znajdziesz w dokumentacji uwierzytelniania.

Korzystanie z API

Po uwierzytelnieniu aplikacji możesz zacząć korzystać z API! Jeśli dopiero poznajesz monday.com, zacznij od podstaw działania platformy w naszym Centrum pomocy (Help Center).

Jeśli znasz już podstawowe elementy monday.com, możesz zapoznać się ze schematem GraphQL tutaj lub w naszym środowisku testowym API (API playground).

Interfejsy API GraphQL używają jednego punktu końcowego do wszystkich operacji (w przeciwieństwie do interfejsów API REST). Punkt końcowy naszego API:\ https://api.monday.com/v2

Żądania do API powinny spełniać następujące zasady:

• Żądanie POST z treścią w formacie JSON
• Token dostępu musi być przesłany w nagłówku Authorization. Więcej informacji znajdziesz tutaj: Uwierzytelnianie
• Wszystkie zapytania (w tym mutacje) należy wysyłać z kluczem query w treści JSON
• Opcjonalne zmienne należy umieścić pod kluczem variables
• Nagłówek Content-Type musi mieć wartość application/json, chyba że przesyłasz pliki
• Nagłówka API-Version należy użyć, aby wywołać określoną wersję API

Treść żądania JSON powinna wyglądać tak:

{
   "query": "query {...}", 
   "variables": { "var1": "value1", "var2": "value2", ... }
}

Przykłady

Poniżej znajdziesz przykłady korzystania z API monday.com w różnych językach:

curl --location 'https://api.monday.com/v2/' \
--header 'Authorization:YOUR_API_KEY_HERE' \
--header 'API-Version: 2023-07' \
--header 'Content-Type: application/json' \
--data '{"query":"query { boards (ids: 1234567890) {name}}"}'

curl -X POST -H "Content-Type:application/json" -H "Authorization:YOUR_API_KEY_HERE" -H "API-Version:2023-07" -d "{\"query\":\"query{boards(ids:1234567890){name}}\"}" "https://api.monday.com/v2/"

fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE',
    'API-Version' : '2023-04'
   },
   body: JSON.stringify({
     'query' : 'query{boards (limit:1) {id name} }'
   })
  });

<?php
$token = 'YOUR_TOKEN_HERE';
$apiUrl = 'https://api.monday.com/v2';
$headers = ['Content-Type: application/json', 'Authorization: ' . $token, 'API-version' : 2023-04];

$query = 'query { boards (limit:1) {id name} }';
$data = @file_get_contents($apiUrl, false, stream_context_create([
  'http' => [
    'method' => 'POST',
    'header' => $headers,
    'content' => json_encode(['query' => $query]),
  ]
]));
$responseContent = json_decode($data, true);

echo json_encode($responseContent);
?>

import requests
import json

apiKey = "YOUR_API_KEY_HERE"
apiUrl = "https://api.monday.com/v2"
headers = {"Authorization" : apiKey, "API-Version" : "2023-04"}

query2 = 'query { boards (limit:1) {id name} }'
data = {'query' : query2}

r = requests.post(url=apiUrl, json=data, headers=headers)

Poniżej znajduje się przykład danych zwróconych przez API:

{
  "data": {
    "boards": [
      {
        "id": "12345678",
        "name": "My Amazing CRM Board"
      }
    ]
  },
  "account_id": 98765
}