API para desarrolladores

Lee y registra transacciones, categorías y fuentes de dinero de tu propia cuenta de Money Tracker desde otro sistema, como un punto de venta o un script. Una clave solo llega a los datos de la cuenta que la creó.

URL base
https://moneytracker.arizu.id
Autenticación
X-Api-Key
X-Api-Secret
Formato
JSON sobre HTTPS
Límites
60 solicitudes por minuto por clave

Obtén una clave

  1. En la app Money Tracker, abre Perfil y elige Claves de API.
  2. Toca Crear clave, ponle un nombre y marca lo que puede hacer.
  3. Copia la API_KEY y el API_SECRET. El secreto solo se muestra una vez.

Cada cuenta puede tener una clave activa. Para cambiarla, revócala en la misma pantalla y crea una nueva. Una clave revocada deja de funcionar al instante.

Autenticación

Envía ambos valores como cabeceras en cada solicitud. Nunca pongas el secreto en una URL, una página web o una app que otras personas puedan abrir.

X-Api-Key
Tu API_KEY. Empieza por mtu_.
X-Api-Secret
Tu API_SECRET, 40 letras y números.
Solicitud
curl "https://moneytracker.arizu.id/api/v1/transactions?month=2026-11&type=income" \
  -H "X-Api-Key: mtu_YOUR_API_KEY" \
  -H "X-Api-Secret: YOUR_API_SECRET"

Permisos

Una clave solo tiene los permisos que marques. Un permiso de escritura incluye el de lectura.

transactions:read
Leer transacciones
transactions:write
Registrar, cambiar y eliminar transacciones
categories:read
Leer categorías
categories:write
Añadir y eliminar categorías
money_sources:read
Leer fuentes de dinero y sus saldos
money_sources:write
Añadir, cambiar y eliminar fuentes de dinero
profile:read
Leer el nombre, el correo, la moneda, el idioma y el plan de la cuenta

Endpoints

Las rutas son relativas a la URL base. Los importes están en la moneda de la cuenta.

Cuenta

  • GET/api/v1/auth/meprofile:read

    El perfil de la cuenta.

Transacciones

  • GET/api/v1/transactionstransactions:read

    Transacciones, de la más reciente a la más antigua. Filtros: month (2026-11), type (income o expense), source_id, page, per_page (hasta 100).

  • GET/api/v1/transactions/{id}transactions:read

    Una transacción.

  • POST/api/v1/transactionstransactions:write

    Registra una transacción. Obligatorios: type, amount, occurred_on (2026-11-02). Opcionales: category_id, payment_source_id, note (hasta 255 caracteres), client_ref.

  • PUT/api/v1/transactions/{id}transactions:write

    Cambia una transacción. Envía los mismos campos que al registrarla, sin client_ref.

  • DELETE/api/v1/transactions/{id}transactions:write

    Elimina una transacción.

Categorías

  • GET/api/v1/categoriescategories:read

    Categorías de ingresos y gastos.

  • POST/api/v1/categoriescategories:write

    Añade una categoría. Obligatorios: type, name. Opcionales: icon, color (#RRGGBB), client_ref.

  • DELETE/api/v1/categories/{id}categories:write

    Elimina una categoría.

Fuentes de dinero

  • GET/api/v1/payment-sourcesmoney_sources:read

    Fuentes de dinero con sus saldos.

  • POST/api/v1/payment-sourcesmoney_sources:write

    Añade una fuente de dinero. Obligatorios: type (bank, card, ewallet o cash), holder_name. Opcionales: bank_name, provider_name, card_type, card_last4, opening_balance, client_ref.

  • PUT/api/v1/payment-sources/{id}money_sources:write

    Cambia una fuente de dinero.

  • DELETE/api/v1/payment-sources/{id}money_sources:write

    Elimina una fuente de dinero.

Cualquier otra ruta responde 403 a una clave de API, aunque la propia app la use.

Ejemplo: registrar una venta

Un punto de venta puede registrar cada venta como ingreso. Da a cada venta su propio client_ref, para que un reintento tras un error de red no registre la venta dos veces.

Solicitud
curl -X POST "https://moneytracker.arizu.id/api/v1/transactions" \
  -H "X-Api-Key: mtu_YOUR_API_KEY" \
  -H "X-Api-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "income",
    "amount": 125000,
    "occurred_on": "2026-11-02",
    "note": "Sale 1042",
    "client_ref": "pos-sale-1042"
  }'

La respuesta tiene el estado 201 y el id de la nueva transacción en data.id.

Respuesta 201
{
  "data": {
    "id": 58213,
    "amount": "125000.00",
    "currency": "IDR",
    "original_amount": null,
    "original_currency": null,
    "fx_rate": null,
    "fx_date": null
  }
}

client_ref tiene de 8 a 64 letras, números o guiones. Si la cuenta ya tiene una transacción con el mismo client_ref, la API devuelve esa transacción en lugar de registrar una nueva.

Respuestas y errores

Una respuesta correcta pone el resultado en data. Una respuesta fallida trae un mensaje en error, en el idioma de la cuenta, y a menudo un code que es igual en todos los idiomas.

Respuesta 403
{
  "error": "This API key does not have the permission for this request",
  "code": "api_key_scope_missing",
  "scope": "transactions:write"
}
401
Falta la clave o el secreto, o es incorrecto, o la clave fue revocada o ha caducado.
403
La clave no tiene permiso para esta solicitud, la ruta está cerrada a las claves de API o la cuenta está bloqueada.
404
El elemento no existe en esta cuenta.
422
Falta un campo o no es válido. Si aparece fields, indica qué corregir.
429
Demasiadas solicitudes. Espera los segundos que indica la cabecera Retry-After.

Límites

Cada clave puede hacer hasta 60 solicitudes por minuto. Los límites de tu plan siguen aplicándose, igual que en la app. En el plan Free, eso significa hasta 30 transacciones nuevas al día.

Mantén tus claves seguras

  • Guarda el secreto en un solo lugar, como los ajustes de tu punto de venta, y no lo compartas por chat ni por correo.
  • Marca solo los permisos que el sistema necesita.
  • Si un secreto se filtra, revoca la clave en la app y crea una nueva.
  • La app muestra cuándo se usó tu clave por última vez. Si no coincide con tus propios sistemas, revoca la clave.

¿Preguntas sobre la API? Escribe a ariefzufar@arizu.id / arizu.team@gmail.com.