Ir al contenido

API

La API de JamCloud permite que un script, una hoja de cálculo u otra aplicación lea y modifique tus espacios: listar pistas, importar archivos, obtener secciones y cifrados. Ve exactamente lo que tú ves, en cada espacio del que eres miembro.

Una clave personal (empieza por jc_) te representa ante la API. No todas las cuentas incluyen claves; un administrador puede concederte el acceso. Sin él, Ajustes › Claves API indica que tu cuenta no incluye acceso a la API.

En Ajustes › Claves API, ponle un nombre a la clave y elige:

  • Solo lectura: la clave lee, nunca cambia nada.
  • Lectura y escritura: la clave también puede importar, editar y eliminar, dentro de tu rol en cada espacio.
  • Su caducidad: nunca, o en 30, 90 o 365 días.

La clave se muestra una sola vez, justo después de Crear clave: cópiala y guárdala en un lugar seguro, como una contraseña. Después la lista solo muestra su inicio, su último uso y su caducidad. Revocar detiene una clave al instante. Puedes tener 10 claves activas.

Envía la clave en el encabezado Authorization:

curl -H "Authorization: Bearer jc_…" https://api-jamcloud.australfactory.cl/api/v1/groups

Esta llamada lista tus espacios. La mayoría de las demás rutas están bajo un espacio (/api/v1/groups/<id>/…).

Una clave nunca llega a tu cuenta: inicio de sesión, perfil, seguridad, notificaciones, otras claves API y administración (/auth, /me, /admin, /realtime, /api-keys) responden 403 con el código api_key_forbidden. Gestiónalos en la aplicación. Una clave de Solo lectura que intenta cambiar algo recibe 403 api_key_read_only.

Cuando la API está apagada temporalmente, cada llamada con una clave recibe 503 circuit_open: espera los segundos que indica el encabezado Retry-After y vuelve a intentarlo. La aplicación sigue funcionando.

La referencia de la API (versión 1) lista cada ruta que una clave puede llamar, con sus parámetros, campos y un ejemplo listo para ejecutar.