Stavte na Tasked
REST API pro projekty, úkoly, klienty, soubory, komentáře k revizím a webhooky. Každá odpověď obsahuje ID požadavku a verzi API; chyby sdílejí jednotnou obálku.
Autentizace
Každý požadavek obsahuje API klíč organizace jako bearer token: Authorization: Bearer tsk_live_... Klíč se generuje pro jednu organizaci pouze s rozsahy, které potřebuje, a lze jej kdykoli zneplatnit.
Klíče můžete vytvářet a zneplatňovat v nastavení organizace na kartě Integrace v části API klíče. API je součástí tarifu Business.
Otevřít nastavení organizaceRozsahy
Klíč obsahuje podskupinu těchto rozsahů; požadavek na koncový bod mimo ně bude odmítnut s kódem 403.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Koncové body
| Metoda | Cesta | Co dělá | Rozsah |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | Není vyžadován žádný klíč |
| 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 |
Dokument OpenAPI
Stejné trasy, těla požadavků a odpovědi jako strojově čitelný formát OpenAPI 3.1, generovaný z validátorů, které API spouští, takže se od nich nemůže odchýlit.
Stáhnout openapi.jsonChyby a limity
Chyba vrací odpověď s { error, errorCode, requestId, apiVersion }. Klíč může odeslat 600 požadavků za minutu, při překročení je odpovědí kód 429. Pro uzamčení verze odešlete X-API-Version; zastaralá verze je označena v hlavičce Deprecation.
Začněte bez platební karty
Čtrnáct dní, všechny funkce aktivní. Otevřete si pracovní prostor, řekněte AI, jak pracujete, a pozvěte klienta ke schválení.
Máte dotaz? Napište nám
Pokud je to možné, odpovídáme přímo z webu, a v případě potřeby se vám ozve člověk. Žádný mailing list.