// API docs

Documentación de la API

Todo lo que necesitas para integrar con los recursos de Tarello. Empieza por "Primeros pasos" o salta directamente al recurso que vas a usar.

Primeros pasos

Para empezar con Tarello necesitas tres cosas: una cuenta, un proyecto y los recursos que tu producto va a consumir.

1. Crea tu cuenta

Entra en console.tarello.io/start y regístrate. Empiezas en el plan gratis: 100 peticiones/mes, 500 MB de almacenamiento y 1 req/s — sin tarjeta.

2. Crea un proyecto

En la Consola, haz clic en Nuevo proyecto. Cada proyecto es un entorno aislado: tiene sus propias claves de API, sus propios datos y la región donde quieras hospedar. Puedes tener todos los proyectos que quieras dentro de la organización.

3. Configura la autenticación

La autenticación viene activa en todo proyecto. En Autenticación, elige qué campos sirven como identificador (e-mail, móvil, usuario) y activa 2FA si quieres. No hace falta programar nada.

4. Crea un recurso

Ve a Recursos del proyecto → Nuevo recurso. Dale un nombre (por ejemplo Facturas) y agrega los campos con sus tipos y reglas. Al guardar, las rutas REST GET /v1/facturas, POST /v1/facturas, etc. ya están activas.

5. Genera una clave de API

En el menú Claves del proyecto, haz clic en Nueva clave. Copia el JWT generado — solo aparece una vez.

6. Primera llamada

Prueba con un curl:

curl https://api.tarello.io/v1/facturas \
  -H "Authorization: Bearer TU_JWT_AQUI"

Si todo está bien, recibes un JSON paginado con la lista de Facturas (vacío si todavía no has creado ninguna).

Próximos pasos