Tài liệu
REST API: bắt đầu nhanh và tài liệu tham chiếu
Xác thực bằng khóa API, giới hạn tốc độ, phân trang và tài liệu tham chiếu OpenAPI 3.1.
Tự động hóa và nhà phát triển
REST API để đọc và ghi kế hoạch
Dự án, tác vụ, phân công và quan hệ phụ thuộc qua REST API, với khóa API theo phạm vi và tài liệu tham chiếu OpenAPI 3.1.
- Có
- Miễn phí, có trong mọi tài khoản
Nó làm gì
Webhook và REST API cho các tự động hóa của riêng bạn
Cho mọi thứ chưa có tích hợp dựng sẵn: một sự kiện có chữ ký ngay khi có gì đó thay đổi, và một API để đọc và ghi kế hoạch.
Hữu ích ở đâu
- Kết nối Planitude với một hệ thống nội bộ, một ERP hoặc một kho dữ liệu.
- Kích hoạt một tự động hóa ngay khi tác vụ được hoàn thành hoặc dời.
- Tạo dự án và tác vụ từ công cụ khác, không cần sao chép thủ công.
Từ Planitude đến Hệ thống của bạn
- Mọi thay đổi, từ ứng dụng web, API, MCP hoặc một lần nhập → Sự kiện có chữ ký, Từ Planitude đến Hệ thống của bạn
Cả hai chiều
- Dự án, tác vụ, phân công và quan hệ phụ thuộc ↔ Đọc và ghi qua REST API, Cả hai chiều
Thiết lập
Kết nối trong ba bước
Tạo khóa API
Trong Hồ sơ → Khóa API, chỉ đọc hoặc đọc và ghi, có thể giới hạn trong một không gian làm việc và kèm ngày hết hạn.
Đăng ký webhook
Trên một dự án hoặc cả không gian làm việc, chọn trong 14 sự kiện: tác vụ được tạo, hoàn thành hoặc dời, quan hệ phụ thuộc, đường cơ sở, bình luận và hơn thế nữa.
Nhận và gọi
Xác minh chữ ký HMAC-SHA256 của từng sự kiện và gọi REST API được mô tả trong OpenAPI 3.1.
Yêu cầu
- Gói
- Miễn phí. Mọi tích hợp đều có trong mọi tài khoản Planitude.
- Ai có thể kết nối
- Mọi người dùng, với khóa API của riêng mình. Webhook dự án: chủ sở hữu hoặc biên tập viên; webhook không gian làm việc: chủ sở hữu hoặc quản trị viên.
- Bạn cần gì
- Một endpoint HTTPS công khai để nhận webhook; với API, một khóa tạo trong Hồ sơ → Khóa API.
Nên biết
- Zapier, Make và n8n sắp ra mắt và sẽ dùng chính API và webhook này.
- Khóa và ứng dụng đã kết nối không thể xóa dự án hay tác vụ: việc xóa chỉ thực hiện trong ứng dụng web.
Hướng dẫn và tài liệu
Tài liệu
Webhook: sự kiện, chữ ký và thử lại
Danh mục sự kiện, xác minh chữ ký HMAC-SHA256 và gửi kèm thử lại.
Hướng dẫn
Các công cụ kết nối với Planitude: hướng dẫn về tích hợp
Các tích hợp của Planitude: Jira, Azure DevOps, Slack, Teams, lịch, ChatGPT, Claude và Gemini qua MCP, API và webhook, tệp .mpp và .xer. Nên chọn cái nào.
Câu hỏi thường gặp về REST API
Làm sao kiểm tra một webhook thực sự đến từ Planitude?
Mỗi yêu cầu mang một header có dấu thời gian và chữ ký HMAC-SHA256 của nội dung: tính lại bằng bí mật webhook và từ chối các yêu cầu quá cũ. Tài liệu nhà phát triển có các ví dụ dựng sẵn.
Một tích hợp API có thể xóa dự án không?
Không. Khóa API và ứng dụng đã kết nối có thể đọc và, với quyền ghi, tạo và cập nhật, nhưng việc xóa dự án và tác vụ chỉ thực hiện trong ứng dụng web.
Các tích hợp có mất phí không?
Không. Mọi tích hợp đều có trong Planitude, vốn miễn phí. Bạn chỉ cần quyền truy cập riêng vào công cụ kia (ví dụ tài khoản Jira, Slack hoặc Microsoft 365) theo điều khoản của chính công cụ đó.
Làm sao để ngắt kết nối một tích hợp?
Từ trang của ứng dụng trong dự án, bằng Ngắt kết nối, bất cứ lúc nào. Không có gì bị xóa: tác vụ vẫn ở trong Planitude, issue và tin nhắn vẫn ở công cụ kia. Các ứng dụng AI đã kết nối được thu hồi từ Hồ sơ → Khóa API.
Các nhãn hiệu được đề cập (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) thuộc về chủ sở hữu tương ứng; Planitude không liên kết hay được họ bảo trợ.