Inicio rápido

La API de Bordio te da acceso programático a tu espacio de trabajo — tareas, eventos, proyectos y definiciones — a través de una sencilla interfaz REST.

1. Obtén una clave de API

Crea una clave secreta en la configuración de tu espacio de trabajo de Bordio. Cada clave tiene un alcance: lectura o lectura-escritura, sobre un espacio de trabajo completo o un único proyecto. Las claves tienen el aspecto brd_sk_live_….

Precaución

Las claves secretas son solo para el lado del servidor. Nunca incrustes una clave en un navegador, una aplicación móvil ni en ningún cliente que no controles.

2. Realiza tu primera solicitud

Envía la clave como un token bearer:

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

Una respuesta correcta se envuelve en un envoltorio data:

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

3. Próximos pasos

• Autenticación — claves, alcances y cabeceras.
• Convenciones — envoltorios, paginación, idempotencia.
• Errores — cómo se reportan los fallos.
• Referencia de la API — todos los endpoints, con un ejecutor de solicitudes integrado.