La API de BrainBox: lleva tus documentos a cualquier sistema
Qué puedes construir con la API de BrainBox, cómo crear una clave y cómo hacer tu primera llamada, con una intranet real de ejemplo.
Lección 1 de 5 · 2:06
De qué trata
La API de BrainBox conecta tus sistemas con tus Boxes: sincronizas documentos desde el ERP, llevas las grabaciones de reuniones, buscas desde tu intranet y auditas accesos. En esta lección creas una clave, haces tu primera llamada y conoces Celtara Hub, la app de ejemplo de todo el curso.
Preguntas frecuentes
›¿Qué puedo hacer con la API de BrainBox?
Crear Boxes, subir e indexar archivos (también por URL, hasta 2 GB), organizar carpetas, mover a la papelera, buscar por significado, traer documentos completos, generar enlaces temporales y gestionar accesos.
›¿Cómo me autentico?
Con una clave API del workspace en el encabezado Authorization: Bearer. La clave se crea en Claves API y solo se muestra una vez.
›¿Las claves del workspace ven mis Boxes personales?
No. Una clave del workspace está limitada a ese workspace.
Transcripción
0:00Muchos sistemas
Julián, de tecnología, tiene la empresa repartida en sistemas: el ERP, la intranet, las videollamadas. ¿Se puede conectar todo a BrainBox? Sí, con la API. Y en este curso vamos a construir una app que lo hace.
0:16Qué puedes construir
Esto es lo que vas a construir. Documentos del ERP que suben solos a su carpeta. Grabaciones de reuniones que llegan solas y se transcriben. Un buscador para tu intranet, que encuentra por significado. Y una auditoría de quién accede a cada Box.
0:33Tu clave
Todo empieza con una clave. En el workspace, en Claves API, toca Crear Clave API. Ponle un nombre que diga qué sistema la usa. Por defecto vence en un año. Crear. La clave se muestra una sola vez. Guárdala como una contraseña: en las variables de entorno de tu servidor, nunca en el código ni en el navegador.
0:55La primera llamada
Una función de diez líneas te sirve para todo el curso. Cada llamada lleva la clave en el encabezado Authorization. Pruebas la conexión, y pides tus Boxes. La respuesta: cada Box con sus archivos y tu rol. Y listar no consume unidades.
1:14Celtara Hub
Esta es Celtara Hub, la intranet que vamos a usar en todo el curso. Prueba la conexión, y a la derecha ves cada llamada a la API, con su respuesta y su tiempo. Y aquí están los Boxes de Celtara, leídos desde la API.
1:29La referencia
Todo está en la referencia de la API. Boxes, archivos, carpetas, papelera, búsqueda y accesos. Y cada endpoint te dice sus parámetros, sus límites y cuántas unidades consume.
1:44Resumen
En resumen: creas una clave del workspace y la guardas en el servidor, cada llamada la lleva en el encabezado, y desde tus sistemas manejas Boxes, archivos, búsqueda y accesos. Julián ya tiene por dónde empezar. Tus documentos, donde ya trabajas.