먼데이닷컴 FAQ
FAQ 목록
요청 만들기
API 인증하기
계정을 설정한 후 다음 단계는 액세스 토큰으로 인증하는 것입니다. 어떻게 API와 앱 사이의 인증이 이루어지는 지 알기 위해서는 인증 섹션에서 확인할 수 있습니다.
API 사용하기
monday.com 구성 요소에 이미 익숙하다면 API playgroung에서 GraphQL 스키마를 살펴보세요.
GraphQL API는 REST API와 달리 모든 작업에 단일 엔드 포인트를 사용합니다. API 엔드포인트는 다음과 같습니다. https://api.monday.com/v2
API 요청은 아래와 같은 규칙을 따라야합니다.
- JSON 형식의 본문으로 POST 요청
- 액세스 토큰은 인증 헤더에서 전송해야 합니다. 자세한 내용은 인증 섹션에서 확인하세요.
- 모든 쿼리(뮤테이션 포함)는 JSON 본문의
query
키와 함께 전송되어야 합니다. - 선택적 변수는
variables
키를 사용해야 합니다. - 파일을 업로드하지 않는 한 컨텐츠 유형 헤더는
application/json
이어야 합니다.
JSON 요청 본문(body)는 다음과 같습니다:
예시
아래의 예시는 다양한 언어를 사용하여 어떻게 monday.com API 를 사용하는 지 보여줍니다.
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)
아래의 예시는 돌아오는 반환값이 어떻게 생겼는지 보여줍니다. GraphQL 은 요청했던 것과 같은 구조로 되돌아 오는 것을 알 수 있습니다.
개발자 모드
개발자 모드는 템플릿 ID, 컬럼 ID, 독스(문서) ID 등을 보여주어 먼데이닷컴 API를 사용할 때 필요한 ID를 쉽게 검색할 수 있습니다.
아래의 방법을 따라 개발자 모드를 활성화 할 수 있습니다:
1. 우측 상단의 프로필을 클릭합니다.
2. monday.labs를 클릭합니다.
3. "developer mode" 를 입력합니다.
4. Active 버튼을 클릭합니다.
최근 업데이트 일자 : 2023. 08. 14