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.
Tus claves API
Sección titulada «Tus claves API»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.
Hacer una llamada
Sección titulada «Hacer una llamada»Envía la clave en el encabezado Authorization:
curl -H "Authorization: Bearer jc_…" https://api-jamcloud.australfactory.cl/api/v1/groupsEsta llamada lista tus espacios. La mayoría de las demás rutas están bajo un espacio (/api/v1/groups/<id>/…).
Lo que una clave no puede hacer
Sección titulada «Lo que una clave no puede hacer»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.
Referencia de la API
Sección titulada «Referencia de la API»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.