Guías
Introducción
La API de SecretarIA te deja trabajar con tus tareas y proyectos desde tu propio código: un script que crea tareas, un backend que las sincroniza con otra herramienta o una integración que las consulta cada pocos minutos.
Qué puedes hacer
- Leer, crear, actualizar y borrar tareas, incluidas las de proyectos compartidos contigo.
- Listar y crear proyectos.
- Comprobar con qué clave y permisos estás llamando.
Son 8 operaciones en total; las tienes todas en la referencia. El chat con la IA queda fuera de la API a propósito: ninguna clave puede usar el modelo.
URL base
Todas las rutas cuelgan de:
https://system.secretar-ia.org/api/v1Las peticiones y las respuestas van en JSON (Content-Type: application/json). La versión va en la
ruta: los cambios que solo añaden (campos o endpoints nuevos) no cambian la v1, así que tu código
debe tolerar campos que no conozca.
Solo desde servidor
Cuidado
La API no envía cabeceras CORS a propósito: no se puede llamar desde JavaScript en el navegador, y no es un error. Una clave incrustada en una web es una clave filtrada. Úsala solo desde servidores, scripts o herramientas de línea de comandos.
Por eso estas páginas no tienen una consola para probar en vivo: cada ejemplo está listo para copiar en curl, Node o Python.
Por dónde empezar
- Crea una clave y haz tu primera llamada.
- Repasa la autenticación y los errores.
- Antes de poner tu integración en marcha, lee los límites de uso y las buenas prácticas.
Si prefieres no escribir las llamadas a mano, puedes descargar la especificación OpenAPI y generar un cliente en tu lenguaje.
¿Integras una app de terceros?
Si estás construyendo una app que conecta con las cuentas de otras personas, mira SecretarIA Connect.