Primeros pasos

Esta guía te lleva de cero a tu primera solicitud autenticada: crea un token, define la URL base y llama a la API.

Requisitos previos

• Acceso a un Workspace que sea elegible para la Public API.
• Permiso para crear tokens en ese Workspace.
• Familiaridad básica con los recursos de Copera — boards, tablas, filas, channels, documentos.

Paso 1 — Crea un Personal Access Token

Un Personal Access Token (PAT, con prefijo cp_pat_) autentica la API como tú y desbloquea la superficie completa de la API. Es la forma más sencilla de empezar.

Abre Workspace Settings

Ve a Workspace Settings → Integrations.

Abre la pestaña Personal Tokens

Selecciona Personal Tokens, luego Create new token.

Nómbralo, asígnale scopes, define la expiración

Dale un nombre al token, selecciona los scopes que necesita y establece una fecha de expiración (hasta 1 año).

Copia el token ahora

El token se muestra solo una vez. Cópialo de inmediato y guárdalo en un gestor de secretos o una variable de entorno.

advertencia

Trata los tokens como contraseñas. Nunca los subas al control de versiones. Si un token se filtra, elimínalo y crea uno nuevo.

Para el desglose completo de los tipos de token y scopes, consulta Autenticación.

Paso 2 — Define la URL base

Todos los endpoints viven bajo:

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

Cada solicitud debe incluir tu token en el encabezado Authorization usando el esquema Bearer:

Authorization: Bearer cp_pat_your_token_here

Paso 3 — Haz tu primera solicitud

Esto lista los boards a los que tu token puede acceder.

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);

Una respuesta 200 devuelve JSON. Un 401 significa que el token falta, está mal formado o expiró — consulta Autenticación. Otras fallas siguen el esquema de errores compartido.

Paso 4 — Envía un mensaje (opcional)

Si tu token tiene el scope access_channels, puedes publicar en un 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!" }'

consejo

Activa el Modo desarrollador para copiar los IDs de recursos (channel, board, table, column) directamente desde la interfaz de Copera — sin necesidad de inspeccionar la red.

Próximos pasos

• Autenticación — tipos de token, scopes y seguridad.
• Paginación — cómo paginan los resultados los endpoints de listado.
• Manejo de errores — códigos de estado y recuperación.
• Límites de tasa — límites por endpoint y backoff.
• Referencia de la API — cada endpoint y esquema.