לבנות על Tasked
REST API לפרויקטים, משימות, לקוחות, קבצים, הערות ביקורת ו-webhooks. כל תשובה נושאת מזהה בקשה וגרסת API; שגיאות חולקות מעטפה אחת.
אימות
כל בקשה נושאת מפתח API של הארגון כ-bearer token: Authorization: Bearer tsk_live_... מפתח מונפק לארגון עם ההרשאות שהוא צריך בלבד, ואפשר לבטל אותו בכל רגע.
יוצרים ומבטלים מפתחות בהגדרות הארגון, בלשונית אינטגרציות, תחת מפתחות API. ה-API כלול במסלול עסקי.
לפתוח את הגדרות הארגוןהרשאות
מפתח נושא תת-קבוצה של ההרשאות האלה; בקשה לנקודת קצה מחוץ להן נדחית עם 403.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
נקודות קצה
| שיטה | נתיב | מה זה עושה | הרשאה |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | בלי מפתח |
| GET | /api/v1/projects | List projects | projects:read |
| POST | /api/v1/projects | Create a project | projects:write |
| GET | /api/v1/projects/{id} | Get a project | projects:read |
| GET | /api/v1/tasks | List tasks | tasks:read |
| POST | /api/v1/tasks | Create a task | tasks:write |
| GET | /api/v1/tasks/{id} | Get a task | tasks:read |
| PATCH | /api/v1/tasks/{id} | Update a task | tasks:write |
| POST | /api/v1/tasks/{id}/move | Move a task to a stage | tasks:write |
| GET | /api/v1/clients | List clients | clients:read |
| POST | /api/v1/clients | Create a client | clients:write |
| GET | /api/v1/clients/{id} | Get a client | clients:read |
| GET | /api/v1/assets | List assets | assets:read |
| GET | /api/v1/assets/{id} | Get an asset | assets:read |
| POST | /api/v1/assets/uploads | Initiate a direct upload | assets:write |
| GET | /api/v1/review-comments | List review comments on an asset | reviews:read |
| GET | /api/v1/webhooks | List webhooks | webhooks:manage |
| POST | /api/v1/webhooks | Create a webhook | webhooks:manage |
| GET | /api/v1/webhooks/{id} | Get a webhook | webhooks:manage |
| PATCH | /api/v1/webhooks/{id} | Update a webhook | webhooks:manage |
| DELETE | /api/v1/webhooks/{id} | Delete a webhook | webhooks:manage |
| GET | /api/v1/webhooks/{id}/deliveries | Delivery log of a webhook | webhooks:manage |
| POST | /api/v1/webhooks/{id}/deliveries/{deliveryId}/replay | Replay a delivery | webhooks:manage |
מסמך OpenAPI
אותם נתיבים, גופי בקשה ותשובות כ-OpenAPI 3.1 קריא למכונה, שנוצר מאותם מאמתים שה-API מריץ, כך שאינו יכול לסטות מהם.
להוריד את openapi.jsonשגיאות ומגבלות
שגיאה עונה עם { error, errorCode, requestId, apiVersion }. מפתח יכול לשלוח 600 בקשות בדקה; מעבר לזה התשובה היא 429. שולחים X-API-Version כדי לנעול גרסה; גרסה שיצאה משימוש מסומנת בכותרת Deprecation.
להתחיל בלי כרטיס אשראי
ארבעה עשר יום ניסיון מלא. פותחים חשבון, מספרים ל-AI איך אתם עובדים, ומזמינים לקוח לאשר.
שאלה? כתבו לנו
עונים מהאתר עצמו כשאפשר, ואדם ממשיך אם צריך. לא שולחים דיוור.