GanttFather API 토큰을 생성하고 v1 REST API를 안전하게 호출하고 할당량 및 멱등성을 처리하고 REST와 MCP 중에서 선택합니다.
GanttFather REST API는 스크립트 및 통합을 위한 버전이 지정된 프로젝트, 작업, 종속성, 멤버 및 리소스 작업을 노출합니다. GanttFather 토큰으로 인증하고, 비어 있지 않은 User-Agent 헤더를 보내고, 읽기 호출로 시작하고, 재시도할 수 있는 작업이나 리소스를 생성할 때 멱등성 키를 사용하세요.
API 동작은 2026년 8월 7일에 확인되었습니다. 실시간 API 참조 엔드포인트 수준 계약으로.
GanttFather API로 무엇을 자동화할 수 있나요?
v1 API는 일반적인 일정 통합 워크플로를 지원합니다.
- 접근 가능한 프로젝트를 나열하고 하나의 프로젝트를 검사합니다.
- 작업, 구성원, 리소스 및 종속성을 나열하고 읽습니다.
- 작업 생성, 부분 업데이트, 재정렬 및 삭제
- 작업 종속성을 추가하거나 제거합니다.
- 리소스 생성, 업데이트 및 삭제
- 외부 레코드와 GanttFather ID 사이에 자신만의 매핑을 첨부하세요.
공개 API는 브라우저의 내부 API와 동일한 표면이 아닙니다. 문서화된 v1 엔드포인트 및 응답 필드만 사용하세요.
API 토큰을 어떻게 생성하고 사용합니까?
GanttFather를 열고 설정 → AI 에이전트 & API로 이동하여 가장 작은 유용한 범위와 권한을 가진 토큰을 생성하세요. 원시 토큰이 표시되면 복사하여 비밀 관리자에 저장합니다. GanttFather는 나중에 표시하기 위해 원시 값을 저장하지 않습니다.
그런 다음 다음 순서를 따르십시오.
- 읽어보세요 인증 가이드.
- 전화 프로젝트 나열 접근 가능한 프로젝트 ID를 찾으세요.
- 쓰기를 시도하기 전에 작업을 읽으십시오.
- 일회용 테스트 작업을 하나 만듭니다.
- 대량 작업 전에 페이지 매김, 재시도 및 할당량 처리를 추가합니다.
모든 요청에는 Bearer 토큰과 클라이언트를 식별하는 비어 있지 않은 User-Agent가 포함되어야 합니다. 누락된 User-Agent는 정상적인 엔드포인트 처리 전에 거부됩니다.
쓰기에는 어떤 안전 규칙이 중요합니까?
통합이 소유한 필드에만 부분 업데이트를 사용하세요. 변경하기 전에 현재 상태를 읽고, 안정적인 ID와 추적 정보를 기록하고, 모든 외부 필드를 무조건 덮어쓰기로 전환하지 마세요.
작업 및 리소스 생성의 경우 시간 초과 또는 네트워크 오류로 인해 재시도가 발생할 수 있는 경우 Idempotency-Key를 보냅니다. 동일한 요청으로 키를 재사용하면 이전 결과가 반환됩니다. 다른 요청으로 재사용하면 충돌이 발생합니다. 업데이트 및 삭제에는 문서화된 의미 체계가 있으며 해당 생성 전용 키를 범용 중복 제거 메커니즘으로 허용하지 않습니다.
종속성과 계층 구조는 별개의 문제입니다. 재정렬은 상위 배치를 변경하는 승인된 방법입니다. 종속성 끝점은 선행자 관계를 모델화합니다. 둘 중 하나를 파생시키는 대신 둘 다 검증하십시오.
비율과 일일 할당량 한도는 어떻게 되나요?
기본 보호는 인증된 토큰당 분당 요청 60개 및 토큰당 일일 요청 5,000개입니다. 제한된 응답은 HTTP 429를 사용하고 재시도 정보를 제공합니다. 현재를 확인하세요 비율 제한 및 할당량 문서 운영 제한은 변경될 수 있으므로 프로덕션 워크로드를 계획하기 전에
올바르게 페이지를 매기고, 일괄적으로 읽고, 안정적인 ID를 캐싱하고, 일련의 필드별 업데이트 대신 하나의 부분 업데이트를 전송하여 요청 볼륨을 줄입니다. 재시도 루프는 Retry-After를 준수해야 하며 지터가 있는 제한된 지수 백오프를 사용해야 합니다.
언제 MCP 대신 REST를 사용해야 합니까?
결정적 애플리케이션 코드에 버전이 지정된 HTTP 리소스, 명시적 오류 응답 및 제어된 재시도 동작이 필요한 경우 REST을(를) 사용하세요. 사용 MCP 서버 Claude와 같은 AI 클라이언트가 Model Context Protocol를 통해 더 높은 수준의 프로젝트 도구를 호출해야 하는 경우.
둘 다 GanttFather의 토큰 레인을 사용할 수 있지만 해당 작업과 멱등성 입력은 서로 바꿔 사용할 수 없습니다. API 통합은 REST 참조를 따라야 합니다. 상담원은 MCP 도구 설명을 따라야 합니다.
안전한 첫 번째 통합 패턴이란 무엇입니까?
각 필드에 대해 하나의 방향과 하나의 소유자로 시작하십시오.
| 단계 | 권장되는 동작 |
|---|---|
| 발견하다 | 프로젝트를 나열하고 선택한 프로젝트 ID를 기록합니다. |
| 읽기 | 현재 작업을 살펴보고 ID 맵을 구축하세요. |
| 비교 | 쓰지 않고 변경 세트 계산 |
| 검토 | 로그 의도 생성, 업데이트 및 삭제 |
| 쓰기 | 지원되는 가장 작은 돌연변이 적용 |
| 확인 | 결과를 읽고 반환된 ID를 기록합니다. |
충돌 소유권, 삭제 규칙, 재시도 및 복구가 정의될 때까지 “동기화”를 주장하지 마십시오.
언제 GanttFather API을 기반으로 구축해야 합니까?
양식, 배포 파이프라인, 고객 포털 또는 내부 시스템에서 팀이 GanttFather에서 보는 것과 동일한 프로젝트 데이터에 반복적으로 액세스해야 하는 경우 API를 사용하세요. 가장 안정적인 첫 번째 사용 사례는 배포 후 릴리스 마일스톤을 생성한 다음 실제 실패 및 재시도를 관찰한 후 확장하는 등 범위가 좁습니다.
API는 어떤 시스템이 필드를 소유하는지 결정하거나 다중 시스템 워크플로를 충돌 없는 상태로 만들지 않습니다. 통합에서는 이러한 규칙을 정의해야 합니다.
GanttFather 프로젝트 만들기, 최소 권한 토큰을 발행하고 생산 기록을 연결하기 전에 일회용 데이터를 테스트합니다.
자주 묻는 질문
API 액세스가 무료 등급에 포함되어 있나요?
API 액세스는 현재 GanttFather 요금제에서 사용할 수 있습니다. 용량 및 보호 제한은 여전히 적용됩니다. 확인하다 가격 페이지 및 현재 조건에 대한 API 할당량 문서입니다.
GanttFather API 토큰은 어떤 모습인가요?
토큰은 GanttFather 토큰 형식을 사용하며 Bearer 자격 증명으로 제공됩니다. 소스 제어에 토큰을 커밋하거나 공개 로그에 포함하지 마십시오.
User-Agent는 선택사항인가요?
일반 v1 요청의 경우 아니요. 제품 이름 및 버전과 같이 통합을 식별하는 비어 있지 않은 값을 보냅니다.
모든 요청에 멱등성 키가 포함되어야 합니까?
아니요. 동일한 요청을 재시도할 수 있는 경우 문서화된 생성 작업에 이를 사용하세요. 범용 버전이나 동시성 헤더가 아닙니다.
API가 Azure DevOps 통합 소스를 구성할 수 있습니까?
공개 v1 프로젝트 데이터 API와 제품의 Azure DevOps 통합은 별도의 표면입니다. 문서화되지 않은 통합 엔드포인트가 존재한다고 가정하지 마십시오.
OpenAPI 문서는 어디에 있나요?
다음부터 시작하세요. GanttFather API 소개 인증, 엔드포인트, 스키마 및 오류에 대한 참조 링크를 따르세요.
