Αναπτύξτε εφαρμογές στο Tasked
Ένα REST API για έργα, εργασίες, πελάτες, αρχεία, σχόλια review και webhooks. Κάθε απάντηση περιλαμβάνει ένα αναγνωριστικό αιτήματος (request id) και την έκδοση του API. Τα σφάλματα μοιράζονται μια κοινή δομή.
Έλεγχος ταυτότητας
Κάθε αίτημα περιλαμβάνει ένα κλειδί API οργανισμού ως bearer token: Authorization: Bearer tsk_live_... Ένα κλειδί εκδίδεται για έναν οργανισμό μόνο με τα scopes που χρειάζεται και μπορεί να ανακληθεί ανά πάσα στιγμή.
Δημιουργήστε και ανακαλέστε κλειδιά στις Ρυθμίσεις οργανισμού, στην καρτέλα Ενσωματώσεις, στην ενότητα Κλειδιά API. Το API περιλαμβάνεται στο πρόγραμμα Business.
Άνοιγμα ρυθμίσεων οργανισμούScopes
Ένα κλειδί περιλαμβάνει ένα υποσύνολο αυτών των scopes. Κάθε αίτημα για endpoint εκτός αυτών απορρίπτεται με σφάλμα 403.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Endpoints
| Μέθοδος | Διαδρομή | Λειτουργία | Scope |
|---|---|---|---|
| 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 |
| POST | /api/v1/assets/uploads/{id}/finalize | Confirm an upload and write the version | 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
Οι ίδιες διαδρομές, σώματα αιτημάτων (request bodies) και απαντήσεις σε μορφή OpenAPI 3.1 αναγνώσιμη από μηχανήματα, που δημιουργούνται από τους επικυρωτές που εκτελεί το API, ώστε να μην υπάρχει καμία απόκλιση.
Λήψη του openapi.jsonΣφάλματα και όρια
Ένα σφάλμα απαντά με { error, errorCode, requestId, apiVersion }. Ένα κλειδί μπορεί να στείλει 600 αιτήματα ανά λεπτό· πέρα από αυτό το όριο, η απάντηση είναι 429. Στείλτε το X-API-Version για να κλειδώσετε μια έκδοση· μια παρωχημένη έκδοση επισημαίνεται στην κεφαλίδα Deprecation.
Ξεκινήστε χωρίς κάρτα
Δεκατέσσερις ημέρες, όλα ενεργοποιημένα. Ανοίξτε έναν χώρο εργασίας, πείτε στο AI πώς εργάζεστε και προσκαλέστε έναν πελάτη να εγκρίνει.
Έχετε κάποια ερώτηση; Γράψτε μας
Απαντάμε απευθείας από τον ιστότοπο όταν είναι εφικτό, και ένας εκπρόσωπός μας θα επικοινωνήσει μαζί σας αν χρειαστεί. Χωρίς λίστες αλληλογραφίας.