Primeiros Passos

Este guia leva voce do zero a sua primeira requisicao autenticada: crie um token, defina a URL base e chame a API.

Pre-requisitos

• Acesso a um workspace elegivel para a Public API.
• Permissao para criar tokens nesse workspace.
• Familiaridade basica com os recursos da Copera — boards, tabelas, linhas, channels, documentos.

Passo 1 — Crie um Personal Access Token

Um Personal Access Token (PAT, com o prefixo cp_pat_) autentica a API como voce e desbloqueia toda a superficie da API. E a forma mais simples de comecar.

Abra as Configuracoes do Workspace

Va em Workspace Settings → Integrations.

Abra a aba Personal Tokens

Selecione Personal Tokens e depois Create new token.

De um nome, defina o escopo e a expiracao

De um nome ao token, selecione os escopos de que ele precisa e defina uma data de expiracao (ate 1 ano).

Copie o token agora

O token e exibido apenas uma vez. Copie-o imediatamente e guarde-o em um gerenciador de segredos ou variavel de ambiente.

aviso

Trate os tokens como senhas. Nunca os adicione ao controle de versao. Se um token vazar, exclua-o e crie um novo.

Para o detalhamento completo dos tipos de token e escopos, veja Autenticacao.

Passo 2 — Defina a URL base

Todos os endpoints ficam sob:

https://api.copera.ai/public/v1

Toda requisicao deve incluir seu token no header Authorization usando o esquema Bearer:

Authorization: Bearer cp_pat_your_token_here

Passo 3 — Faca sua primeira requisicao

Isto lista os boards que seu token pode acessar.

curl

curl https://api.copera.ai/public/v1/board/list-boards \
  -H "Authorization: Bearer cp_pat_your_token_here"

JavaScript

const res = await fetch(
  "https://api.copera.ai/public/v1/board/list-boards",
  {
    headers: {
      Authorization: "Bearer cp_pat_your_token_here",
    },
  },
);

if (!res.ok) {
  const error = await res.json();
  throw new Error(`${res.status}: ${error.message}`);
}

const boards = await res.json();
console.log(boards);

Uma resposta 200 retorna JSON. Um 401 significa que o token esta ausente, malformado ou expirado — veja Autenticacao. Outras falhas seguem o schema de erro compartilhado.

Passo 4 — Envie uma mensagem (opcional)

Se o seu token tiver o escopo access_channels, voce pode publicar em um channel:

curl -X POST \
  https://api.copera.ai/public/v1/chat/channel/{channelId}/send-message \
  -H "Authorization: Bearer cp_pat_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Hello from my integration!" }'

dica

Ative o Modo Desenvolvedor para copiar IDs de recursos (channel, board, table, column) direto da interface da Copera — sem precisar inspecionar a rede.

Proximos passos

• Autenticacao — tipos de token, escopos e seguranca.
• Paginacao — como os endpoints de listagem paginam os resultados.
• Tratamento de Erros — codigos de status e recuperacao.
• Limites de Requisicao — limites por endpoint e backoff.
• Referencia da API — cada endpoint e schema.