forja
Empezar gratis

Empezar en 10 minutos

Vas a crear una cuenta, armar una tabla de turnos, activar su API y leer y escribir datos desde la terminal. Todo con el plan gratuito.

1. Creá tu cuenta y tu proyecto

Entrá a app.getforja.site y registrate con tu mail o con Google. Si te registrás con mail, te llega un mensaje para verificarlo. Después creá un proyecto: es el contenedor de tus tablas, funciones y llaves. El plan Free incluye un proyecto.

2. Armá una tabla

En la sección Tablas creás una tabla y le agregás columnas. También podés pedírselo al asistente en español, por ejemplo: "Armame una tabla de turnos con el nombre del cliente y el día", y la crea sobre tu proyecto. Los cambios de estructura se aplican al instante.

3. Activá la API de la tabla

Por seguridad, una tabla nueva no está expuesta: la API viene apagada. En la lista de tablas, encendé el interruptor de la API de esa tabla. Mientras esté apagada, la API responde igual que si la tabla no existiera.

4. Creá una llave

En Staging y API keys, pestaña Llaves, creá una llave y marcale los permisos que necesite:Leer datos para consultar y Escribir datos para crear, editar y borrar. La llave se muestra una sola vez al crearla, así que guardala. Las llaves de producción empiezan con fk_live_. Más detalles enLlaves y permisos.

5. Tu primera llamada

En la pestaña Conectar están la URL de la API (https://api.getforja.site) y el ID de tu proyecto. Con eso, listá los registros de tu tabla:

Terminal
curl "https://api.getforja.site/v1/tables/<ID_DEL_PROYECTO>/turnos?limit=20" \
  -H "Authorization: Bearer <TU_LLAVE>"

Respuesta:

JSON
{
  "records": [
    { "id": "6f1c…", "cliente": "Ana", "dia": "2026-11-03", "created_at": "…", "updated_at": "…" }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

Para crear un registro, mandá los campos de la tabla:

Terminal
curl -X POST "https://api.getforja.site/v1/tables/<ID_DEL_PROYECTO>/turnos" \
  -H "Authorization: Bearer <TU_LLAVE>" \
  -H "Content-Type: application/json" \
  -d '{ "cliente": "Ana", "dia": "2026-11-03" }'

Desde JavaScript, en el servidor de tu app:

JavaScript
const res = await fetch(
  "https://api.getforja.site/v1/tables/<ID_DEL_PROYECTO>/turnos?limit=20",
  { headers: { Authorization: "Bearer " + process.env.FORJA_KEY } },
);
const { records, total } = await res.json();

No pongas una llave con permiso de escritura en el código de una página web. Cualquiera que abra tu página la puede ver y usar. Para el navegador hay llaves públicas, que solo leen. Está explicado enLlaves y permisos.

Siguientes pasos

Información revisada el 2026-10-24.