--- title: "REST API để đọc và ghi kế hoạch" description: "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." url: https://planitude.app/vi/integrations/api language: vi --- # 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 · Tự động hóa và nhà phát triển ## 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. ### Điều gì đi đâu **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ý **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 ## Kết nối trong ba bước 1. **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. 2. **Đă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. 3. **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 - [REST API: bắt đầu nhanh và tài liệu tham chiếu](https://planitude.app/vi/developers#quickstart): 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. - [Webhook: sự kiện, chữ ký và thử lại](https://planitude.app/vi/developers#webhooks): Danh mục sự kiện, xác minh chữ ký HMAC-SHA256 và gửi kèm thử lại. - [Các công cụ kết nối với Planitude: hướng dẫn về tích hợp](https://planitude.app/vi/blog/planitude-integrations-guide): 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ụ đó. ## Tích hợp liên quan - [Webhook](https://planitude.app/vi/integrations/webhooks): Sự kiện HTTPS có chữ ký mỗi khi có gì đó thay đổi trong dự án. - [Zapier](https://planitude.app/vi/integrations/zapier): Trigger và hành động cho hàng nghìn ứng dụng. - [Make](https://planitude.app/vi/integrations/make): Kịch bản với các module Planitude và trigger tức thời. - [n8n](https://planitude.app/vi/integrations/n8n): Node cộng đồng, cũng dùng cho n8n tự lưu trữ. ## Kết nối REST API với Planitude Tạo tài khoản miễn phí, mở một dự án và chọn Tích hợp từ menu ⋯. Chỉ mất hai phút. [Tạo tài khoản miễn phí](https://planitude.app/vi/signup) *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ợ.*