--- title: "계획을 읽고 쓰는 REST API" description: "스코프가 지정된 API 키와 OpenAPI 3.1 레퍼런스를 갖춘 REST API로 프로젝트, 작업, 배정, 종속 관계를 다룹니다." url: https://planitude.app/ko/integrations/api language: ko --- # 계획을 읽고 쓰는 REST API 스코프가 지정된 API 키와 OpenAPI 3.1 레퍼런스를 갖춘 REST API로 프로젝트, 작업, 배정, 종속 관계를 다룹니다. 사용 가능 · 무료, 모든 계정에 포함 · 자동화 및 개발자 ## 자체 자동화를 위한 웹훅과 REST API 기본 제공 연동이 없는 모든 경우를 위한 기능입니다. 변경이 생기는 즉시 서명된 이벤트를 받고, API로 계획을 읽고 쓸 수 있습니다. ### 활용 사례 - Planitude를 사내 시스템, ERP 또는 데이터 웨어하우스에 연결합니다. - 작업이 완료되거나 이동되는 즉시 자동화를 실행합니다. - 다른 도구에서 프로젝트와 작업을 직접 복사하지 않고 생성합니다. ### 무엇이 어디로 전달되는지 **Planitude에서 내 시스템(으)로** - 웹 앱, API, MCP, 가져오기에서 발생하는 모든 변경 → 서명된 이벤트 **양방향** - 프로젝트, 작업, 배정, 종속 관계 ↔ REST API로 읽기 및 쓰기 ## 세 단계로 연결하세요 1. **API 키 만들기**: 프로필 → API 키에서 읽기 전용 또는 읽기·쓰기 키를 만드세요. 필요하면 하나의 워크스페이스로 제한하고 만료일을 설정할 수 있습니다. 2. **웹훅 등록**: 하나의 프로젝트 또는 전체 워크스페이스에 대해 14개 이벤트 중에서 선택합니다. 작업 생성, 완료, 이동, 종속 관계, 기준선, 댓글 등이 있습니다. 3. **수신 및 호출**: 각 이벤트의 HMAC-SHA256 서명을 검증하고 OpenAPI 3.1로 문서화된 REST API를 호출하세요. ## 요구 사항 - **요금제**: 무료. 모든 연동이 모든 Planitude 계정에 포함됩니다. - **연결할 수 있는 사용자**: 모든 사용자가 본인의 API 키로 사용합니다. 프로젝트 웹훅은 소유자 또는 편집자, 워크스페이스 웹훅은 소유자 또는 관리자가 설정할 수 있습니다. - **필요한 것**: 웹훅을 수신할 공개 HTTPS 엔드포인트. API를 사용하려면 프로필 → API 키에서 만든 키가 필요합니다. ## 참고 사항 - Zapier, Make, n8n은 출시 예정이며 이와 동일한 API와 웹훅을 사용합니다. - 키와 연결된 앱은 프로젝트나 작업을 삭제할 수 없습니다. 삭제는 웹 앱에서만 가능합니다. ## 가이드 및 문서 - [REST API: 빠른 시작 및 레퍼런스](https://planitude.app/ko/developers#quickstart): API 키 인증, 요청 한도, 페이지 매김, OpenAPI 3.1 레퍼런스. - [웹훅: 이벤트, 서명, 재시도](https://planitude.app/ko/developers#webhooks): 이벤트 카탈로그, HMAC-SHA256 서명 검증, 재시도를 포함한 전달. - [Planitude에 연결할 수 있는 도구: 연동 가이드](https://planitude.app/ko/blog/planitude-integrations-guide): Planitude 연동: Jira, Azure DevOps, Slack, Teams, 캘린더, MCP를 통한 ChatGPT, Claude, Gemini, API와 웹훅, .mpp 및 .xer 파일. 무엇을 선택해야 할까요? ## REST API에 관한 자주 묻는 질문 ### 웹훅이 실제로 Planitude에서 온 것인지 어떻게 확인하나요? 모든 요청에는 타임스탬프와 본문의 HMAC-SHA256 서명이 담긴 헤더가 포함됩니다. 웹훅 시크릿으로 서명을 다시 계산하고, 너무 오래된 요청은 거부하세요. 개발자 문서에서 바로 쓸 수 있는 예제를 제공합니다. ### API 연동으로 프로젝트를 삭제할 수 있나요? 아니요. API 키와 연결된 앱은 읽을 수 있고, 쓰기 권한이 있으면 생성과 업데이트도 할 수 있지만 프로젝트와 작업의 삭제는 웹 앱에서만 가능합니다. ### 연동에 비용이 드나요? 아니요. 모든 연동은 무료인 Planitude에 포함되어 있습니다. 다른 도구(예: Jira, Slack, Microsoft 365 계정)에 대한 접근 권한은 해당 서비스의 약관에 따라 별도로 필요합니다. ## 관련 연동 - [웹훅](https://planitude.app/ko/integrations/webhooks): 프로젝트에서 변경이 있을 때마다 서명된 HTTPS 이벤트를 전송합니다. - [Zapier](https://planitude.app/ko/integrations/zapier): 수천 개 앱을 위한 트리거와 액션. - [Make](https://planitude.app/ko/integrations/make): Planitude 모듈과 즉시 트리거를 사용하는 시나리오. - [n8n](https://planitude.app/ko/integrations/n8n): 셀프 호스팅 n8n에서도 쓸 수 있는 커뮤니티 노드. ## REST API을(를) Planitude에 연결하세요 무료 계정을 만들고 프로젝트를 연 다음 ⋯ 메뉴에서 연동을 선택하세요. 2분이면 충분합니다. [무료 계정 만들기](https://planitude.app/ko/signup) *언급된 상표(Jira, Azure DevOps, Slack, Microsoft Teams, Microsoft Outlook, Microsoft PowerPoint, Microsoft Project, Visual Studio Code, Google Calendar, Gemini, Apple Calendar, ChatGPT, Codex, Claude, Cursor, Zapier, Make, n8n, Primavera)은 각 소유자의 자산이며, Planitude는 이들과 제휴 관계에 있거나 보증을 받은 것이 아닙니다.*