Buduj na Tasked
REST API dla projektów, zadań, klientów, zasobów, komentarzy do recenzji i webhooków. Każda odpowiedź zawiera identyfikator żądania i wersję API; błędy współdzielą jedną kopertę.
Uwierzytelnianie
Każde zapytanie zawiera klucz API organizacji jako token bearer: Authorization: Bearer tsk_live_... Klucz jest generowany dla jednej organizacji wyłącznie z wymaganymi zakresami i może zostać unieważniony w dowolnym momencie.
Twórz i unieważniaj klucze w ustawieniach organizacji, w zakładce Integracje, w sekcji Klucze API. API jest dostępne w planie Biznes.
Otwórz ustawienia organizacjiZakresy
Klucz posiada podzbiór tych zakresów; zapytanie do punktu końcowego spoza tego podzbioru zostanie odrzucone z błędem 403.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Punkty końcowe
| Metoda | Ścieżka | Opis działania | Zakres |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | Klucz nie jest wymagany |
| 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
Te same ścieżki, treści żądań i odpowiedzi w czytelnym dla maszyn formacie OpenAPI 3.1, generowane bezpośrednio z walidatorów uruchamianych przez API, co zapobiega powstawaniu rozbieżności.
Pobierz openapi.jsonBłędy i limity
Błąd zwraca odpowiedź z { error, errorCode, requestId, apiVersion }. Klucz może wysłać 600 żądań na minutę; powyżej tego limitu odpowiedź to 429. Wyślij X-API-Version, aby przypiąć wersję; wersja wycofana z użycia jest oznaczona w nagłówku Deprecation.
Zacznij bez karty
Czternaście dni, wszystkie funkcje włączone. Otwórz obszar roboczy, powiedz AI, jak pracujesz, i zaproś klienta do akceptacji.
Masz pytanie? Napisz do nas
Odpowiadamy bezpośrednio na stronie, kiedy tylko możemy, a w razie potrzeby kontaktuje się z Tobą człowiek. Żadnych list mailingowych.