Desenvolva no Tasked
Uma REST API para projetos, tarefas, clientes, ficheiros, comentários de revisão e webhooks. Cada resposta inclui um ID de pedido e a versão da API; os erros partilham o mesmo envelope.
Autenticação
Cada pedido inclui uma chave de API da organização como um bearer token: Authorization: Bearer tsk_live_... A chave é gerada para uma organização apenas com os âmbitos necessários e pode ser revogada a qualquer momento.
Crie e revogue chaves nas definições da organização, no separador Integrações, em Chaves de API. A API está incluída no plano Business.
Abrir definições da organizaçãoÂmbitos
Uma chave contém um subconjunto destes âmbitos; qualquer pedido para um endpoint fora dos mesmos será recusado com o código 403.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Endpoints
| Método | Caminho | O que faz | Âmbito |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | Nenhuma chave necessária |
| 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 |
Documento OpenAPI
As mesmas rotas, corpos de pedido e respostas em formato OpenAPI 3.1 legível por máquina, gerados a partir dos validadores executados pela API, garantindo que não há divergências.
Descarregar openapi.jsonErros e limites
Um erro responde com { error, errorCode, requestId, apiVersion }. Uma chave pode enviar 600 pedidos por minuto; além disso, a resposta é 429. Envie X-API-Version para fixar uma versão; uma versão descontinuada é sinalizada no cabeçalho Deprecation.
Comece sem cartão
Catorze dias, tudo ativo. Abra um espaço de trabalho, diga à IA como trabalha e convide um cliente para aprovar.
Uma pergunta? Escreva-nos
Respondemos a partir do próprio site quando possível, e uma pessoa fará o acompanhamento se necessário. Sem listas de distribuição.