REST API가 중요한 이유
새 API reference는 팀이 GanttFather 위에 직접 도구를 만들 수 있게 해 줍니다. 스프레드시트를 내보내고, 다른 곳에서 수정하고, 다시 가져오는 대신 스크립트가 앱에서 팀이 보는 동일한 프로젝트 데이터를 읽고 쓸 수 있습니다.
이는 운영팀, 에이전시, 창업자, 내부 도구 개발자에게 중요합니다. Gantt chart는 실제 업무 가까이에 있을 때 가장 유용합니다. API는 cron job, dashboard, 고객 포털, 배포 pipeline, 가벼운 integration에서 이 작업을 가능하게 합니다.
무엇을 자동화할 수 있나요?
첫 번째 공개 API surface는 사람들이 가장 자주 자동화하려는 프로젝트 데이터에 집중합니다.
- token이 접근할 수 있는 프로젝트 목록 보기
- 작업 읽기, 생성, 업데이트, 재정렬, 삭제
- 상태와 진행률을 동기화 상태로 유지
- 담당자와 task dependency 설정
- 멤버와 리소스 목록 보기
- 장비, 회의실, 예산 항목 같은 비인적 리소스 생성, 업데이트, 제거
실제로는 내부 intake form에서 launch plan을 만들고, 배포가 끝났을 때 milestone을 업데이트하거나, 다른 도구의 선택된 작업을 GanttFather timeline에 반영할 수 있습니다.
시작하는 방법
GanttFather를 열고 Settings → AI Agents & API로 이동한 뒤 token을 만드세요. 그런 다음:
- authentication guide를 읽습니다.
- list projects를 호출해 project id를 찾습니다.
- 작은 테스트 항목으로 create task를 시도합니다.
- 대량 sync job을 실행하기 전에 pagination과 rate limits를 확인합니다.
curl https://api.ganttfather.com/v1/projects \
-H "Authorization: Bearer glt_your_token" \
-H "User-Agent: your-integration-name/1.0"User-Agent는 의도적으로 필요합니다. 실제 integration을 support가 추적하고, edge case를 debug하며, API traffic을 익명 browser traffic과 구분하는 데 도움이 됩니다.
API versus MCP
코드를 작성하고 안정적인 HTTP endpoint가 필요하면 REST API를 사용하세요. Claude, ChatGPT, Cursor, Windsurf 같은 AI assistant가 더 높은 수준의 tools로 프로젝트를 다루게 하려면 MCP server guide를 사용하세요.
둘 다 GanttFather의 같은 token area를 사용하며 모든 사용자에게 포함됩니다. 차이는 interface입니다. REST는 program을 위한 것이고, MCP는 agent를 위한 것입니다.
가격과 제한
API access는 모든 plan에 포함됩니다. pricing page는 여전히 같은 규칙을 따릅니다. 모든 feature는 첫날부터 사용할 수 있고, paid upgrade는 capacity만 추가합니다. 즉, 소유한 project를 늘리거나 active editor를 늘리는 것입니다.
기본 API limit은 token당 분당 60 request 및 token당 하루 5,000 request입니다. 제한된 request는 Retry-After가 포함된 429를 반환합니다. 일일 quota 응답에는 X-Quota-Remaining이 포함됩니다. 큰 sync에서는 write를 batch 처리하고 field별 update loop를 피하세요. Rate limits & quotas를 참고하세요.
통합 패턴
가장 깔끔한 integration은 보통 이런 형태를 따릅니다.
- 자체 system id와 GanttFather task id 사이의 작은 mapping 유지
- 쓰기 전에 현재 project state 읽기
- 변경된 field에 대해서만 partial update 보내기
- retry하는 create-style operation에는 idempotency key 사용
- 실패 시 GanttFather trace id 기록
작게 시작하세요. projects를 list하고, task 하나를 만들고, 업데이트한 다음, 그 flow를 자신의 system에 연결하세요.
Start with a token하고 reference를 editor 옆에 열어 두세요.