문서
웹훅: 이벤트, 서명, 재시도
이벤트 카탈로그, HMAC-SHA256 서명 검증, 재시도를 포함한 전달.
기능
자체 자동화를 위한 웹훅과 REST API
기본 제공 연동이 없는 모든 경우를 위한 기능입니다. 변경이 생기는 즉시 서명된 이벤트를 받고, API로 계획을 읽고 쓸 수 있습니다.
활용 사례
- Planitude를 사내 시스템, ERP 또는 데이터 웨어하우스에 연결합니다.
- 작업이 완료되거나 이동되는 즉시 자동화를 실행합니다.
- 다른 도구에서 프로젝트와 작업을 직접 복사하지 않고 생성합니다.
Planitude에서 내 시스템(으)로
- 웹 앱, API, MCP, 가져오기에서 발생하는 모든 변경 → 서명된 이벤트, Planitude에서 내 시스템(으)로
양방향
- 프로젝트, 작업, 배정, 종속 관계 ↔ REST API로 읽기 및 쓰기, 양방향
설정
세 단계로 연결하세요
API 키 만들기
프로필 → API 키에서 읽기 전용 또는 읽기·쓰기 키를 만드세요. 필요하면 하나의 워크스페이스로 제한하고 만료일을 설정할 수 있습니다.
웹훅 등록
하나의 프로젝트 또는 전체 워크스페이스에 대해 14개 이벤트 중에서 선택합니다. 작업 생성, 완료, 이동, 종속 관계, 기준선, 댓글 등이 있습니다.
수신 및 호출
각 이벤트의 HMAC-SHA256 서명을 검증하고 OpenAPI 3.1로 문서화된 REST API를 호출하세요.
요구 사항
- 요금제
- 무료. 모든 연동이 모든 Planitude 계정에 포함됩니다.
- 연결할 수 있는 사용자
- 모든 사용자가 본인의 API 키로 사용합니다. 프로젝트 웹훅은 소유자 또는 편집자, 워크스페이스 웹훅은 소유자 또는 관리자가 설정할 수 있습니다.
- 필요한 것
- 웹훅을 수신할 공개 HTTPS 엔드포인트. API를 사용하려면 프로필 → API 키에서 만든 키가 필요합니다.
참고 사항
- Zapier, Make, n8n은 출시 예정이며 이와 동일한 API와 웹훅을 사용합니다.
- 키와 연결된 앱은 프로젝트나 작업을 삭제할 수 없습니다. 삭제는 웹 앱에서만 가능합니다.
가이드 및 문서
문서
REST API: 빠른 시작 및 레퍼런스
API 키 인증, 요청 한도, 페이지 매김, OpenAPI 3.1 레퍼런스.
가이드
Planitude에 연결할 수 있는 도구: 연동 가이드
Planitude 연동: Jira, Azure DevOps, Slack, Teams, 캘린더, MCP를 통한 ChatGPT, Claude, Gemini, API와 웹훅, .mpp 및 .xer 파일. 무엇을 선택해야 할까요?
웹훅에 관한 자주 묻는 질문
웹훅이 실제로 Planitude에서 온 것인지 어떻게 확인하나요?
모든 요청에는 타임스탬프와 본문의 HMAC-SHA256 서명이 담긴 헤더가 포함됩니다. 웹훅 시크릿으로 서명을 다시 계산하고, 너무 오래된 요청은 거부하세요. 개발자 문서에서 바로 쓸 수 있는 예제를 제공합니다.
API 연동으로 프로젝트를 삭제할 수 있나요?
아니요. API 키와 연결된 앱은 읽을 수 있고, 쓰기 권한이 있으면 생성과 업데이트도 할 수 있지만 프로젝트와 작업의 삭제는 웹 앱에서만 가능합니다.
연동에 비용이 드나요?
아니요. 모든 연동은 무료인 Planitude에 포함되어 있습니다. 다른 도구(예: Jira, Slack, Microsoft 365 계정)에 대한 접근 권한은 해당 서비스의 약관에 따라 별도로 필요합니다.
연동을 해제하려면 어떻게 하나요?
프로젝트의 앱 페이지에서 연결 해제를 선택하면 언제든지 해제할 수 있습니다. 삭제되는 항목은 없으며 작업은 Planitude에, 이슈와 메시지는 다른 도구에 남습니다. 연결된 AI 앱은 프로필 → API 키에서 해제합니다.
언급된 상표(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는 이들과 제휴 관계에 있거나 보증을 받은 것이 아닙니다.