Início rápido

A API do Bordio fornece acesso programático ao seu espaço de trabalho — tarefas, eventos, projetos e definições — por meio de uma interface REST simples.

1. Obtenha uma chave de API

Crie uma chave secreta nas configurações do seu espaço de trabalho no Bordio. Cada chave tem escopo: leitura ou leitura-escrita, sobre um espaço de trabalho inteiro ou um único projeto. As chaves se parecem com brd_sk_live_….

2. Faça sua primeira requisição

Envie a chave como um token bearer:

curl https://api.bordio.com/public/v1/tasks \
  -H "Authorization: Bearer brd_sk_live_..."

Uma resposta bem-sucedida é encapsulada em um envelope data:

{
  "data": [
    { "id": "task_6a2918cff58b0a1d387866ee", "title": "Ship the API", "priority": "high" }
  ],
  "pagination": { "next_cursor": null, "has_more": false }
}

3. Próximos passos

Autenticação — chaves, escopos e cabeçalhos.
Convenções — envelopes, paginação, idempotência.
Erros — como as falhas são reportadas.
Referência da API — todos os endpoints, com um executor de requisições integrado.