תיעוד
REST API: התחלה מהירה ומדריך
אימות באמצעות מפתח API, מגבלות קצב, עימוד ומדריך OpenAPI 3.1.
אוטומציה ומפתחים
REST API לקריאה ולכתיבה של תוכניות
פרויקטים, משימות, שיוכים ותלויות דרך REST API, עם מפתחות API בהיקף מוגדר ומדריך OpenAPI 3.1.
- זמין
- חינם, כלול בכל חשבון
מה זה עושה
Webhooks ו-REST API לאוטומציות שלכם
לכל מה שאין לו אינטגרציה מוכנה: אירוע חתום ברגע שמשהו משתנה, ו-API לקריאה ולכתיבה של התוכנית.
איפה זה עוזר
- חברו את Planitude למערכת פנימית, ל-ERP או למחסן נתונים.
- הפעילו אוטומציה ברגע שמשימה מושלמת או מוזזת.
- צרו פרויקטים ומשימות מכלי אחר, בלי להעתיק אותם ידנית.
מ-Planitude אל המערכת שלכם
- כל שינוי, מאפליקציית האינטרנט, מה-API, מ-MCP או מייבוא → אירועים חתומים, מ-Planitude אל המערכת שלכם
בשני הכיוונים
- פרויקטים, משימות, שיוכים ותלויות ↔ קריאה וכתיבה באמצעות REST API, בשני הכיוונים
הגדרה
מחברים בשלושה שלבים
יצירת מפתח API
בפרופיל ← מפתחות API, לקריאה בלבד או לקריאה וכתיבה, עם הגבלה אופציונלית לסביבת עבודה אחת ותאריך תפוגה.
רישום webhook
על פרויקט אחד או על סביבת עבודה שלמה, בבחירה מתוך 14 אירועים: משימות שנוצרו, הושלמו או הוזזו, תלויות, קווי בסיס, תגובות ועוד.
מקבלים וקוראים
אמתו את חתימת HMAC-SHA256 של כל אירוע וקראו ל-REST API המתועד ב-OpenAPI 3.1.
דרישות
- תוכנית
- חינם. כל אינטגרציה כלולה בכל חשבון Planitude.
- מי יכול לחבר
- כל משתמש, עם מפתח API משלו. webhooks של פרויקט: בעלים או עורך; webhooks של סביבת עבודה: בעלים או מנהל.
- מה צריך
- נקודת קצה ציבורית ב-HTTPS לקבלת webhooks; עבור ה-API, מפתח שנוצר בפרופיל ← מפתחות API.
כדאי לדעת
- Zapier, Make ו-n8n יגיעו בקרוב וישתמשו באותו API ובאותם webhooks.
- מפתחות ואפליקציות מחוברות אינם יכולים למחוק פרויקטים או משימות: המחיקה נשארת באפליקציית האינטרנט.
מדריכים ותיעוד
תיעוד
Webhooks: אירועים, חתימות וניסיונות חוזרים
קטלוג אירועים, אימות חתימת HMAC-SHA256 ומסירה עם ניסיונות חוזרים.
מדריך
הכלים שאפשר לחבר ל-Planitude: מדריך לאינטגרציות
אינטגרציות Planitude: Jira, Azure DevOps, Slack, Teams, יומנים, ChatGPT, Claude ו-Gemini דרך MCP, API ו-webhooks, קובצי .mpp ו-.xer. במה לבחור.
שאלות נפוצות על REST API
איך אני בודק ש-webhook באמת מגיע מ-Planitude?
כל בקשה נושאת כותרת עם חותמת זמן וחתימת HMAC-SHA256 של הגוף: חשבו אותה מחדש עם סוד ה-webhook ודחו בקשות ישנות מדי. בתיעוד למפתחים יש דוגמאות מוכנות.
האם אינטגרציית API יכולה למחוק פרויקטים?
לא. מפתחות API ואפליקציות מחוברות יכולים לקרוא, ועם גישת כתיבה ליצור ולעדכן, אבל מחיקת פרויקטים ומשימות נשארת באפליקציית האינטרנט.
האם האינטגרציות עולות משהו?
לא. כל אינטגרציה כלולה ב-Planitude, שהיא חינמית. נדרשת רק גישה משלכם לכלי האחר (למשל חשבון Jira, Slack או Microsoft 365) בהתאם לתנאים שלו.
איך מנתקים אינטגרציה?
מעמוד האפליקציה בפרויקט, באמצעות ניתוק, בכל עת. שום דבר לא נמחק: המשימות נשארות ב-Planitude, הבעיות וההודעות נשארות בכלי האחר. אפליקציות בינה מלאכותית מחוברות מבוטלות מפרופיל ← מפתחות 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 אינה קשורה אליהם ואינה מאושרת על ידם.