PlataAPI para programadores
# API para programadores La API es para conectar tus programas. Es de [Plus](/ayuda/plus) y solo trabaja con los registros: leer el historial y crear ingresos, gastos y transferencias. Para todo lo demás está el [MCP](/ayuda/mcp). La base es `https://plata.creceideas.com/api/v1`, y cada llamada lleva la cabecera `Authorization: Bearer plata_...`. Creas la clave en Configuración, API y MCP, pestaña API. Dura 1 año. ## Puntos de acceso - `GET /accounts`: tus cuentas, para saber sus id. - `GET /categories`: tus categorías, para saber sus id. - `GET /records`: el historial. Filtros: `from`, `to`, `account_id`, `type` y `limit`. - `POST /records`: anota un ingreso o un gasto. - `POST /transfers`: anota una transferencia. - `GET /usage`: tu consumo, sin gastar cuota. - `GET /tools`: la lista de herramientas, con sus datos. ## Anotar un gasto ``` curl -X POST https://plata.creceideas.com/api/v1/records -H "Authorization: Bearer plata_..." -H "Content-Type: application/json" -d '{"type":"EXPENSE","amount":5,"account_id":"ID","note":"Café"}' ``` ## Anotar una transferencia ``` curl -X POST https://plata.creceideas.com/api/v1/transfers -H "Authorization: Bearer plata_..." -H "Content-Type: application/json" -d '{"from_account_id":"ID","to_account_id":"ID","from_amount":10,"to_amount":8900}' ``` ## Cuotas Se cuenta por llamadas, no por caracteres ni tokens: anotar un ingreso es una escritura, anotar un gasto es otra, y ver tus cuentas es una lectura. La API y el MCP gastan de la misma cuota. - 100 escrituras al día y 1.500 al mes. - 500 lecturas al día y 5.000 al mes. - 30 llamadas por minuto, y 3 conexiones como máximo. ## Errores - `401`: la clave no es válida o venció. - `403`: hace falta Plus, o esa herramienta solo está en el MCP. - `429`: te pasaste de la cuota o del límite por minuto; la respuesta dice cuál.La API es para conectar tus programas. Es de Plus y solo trabaja con los registros: leer el historial y crear ingresos, gastos y transferencias. Para todo lo demás está el MCP.
La base es https://plata.creceideas.com/api/v1, y cada llamada lleva la cabecera Authorization: Bearer plata_.... Creas la clave en Configuración, API y MCP, pestaña API. Dura 1 año.
Puntos de acceso
GET /accounts: tus cuentas, para saber sus id.GET /categories: tus categorías, para saber sus id.GET /records: el historial. Filtros:from,to,account_id,typeylimit.POST /records: anota un ingreso o un gasto.POST /transfers: anota una transferencia.GET /usage: tu consumo, sin gastar cuota.GET /tools: la lista de herramientas, con sus datos.
Anotar un gasto
curl -X POST https://plata.creceideas.com/api/v1/records -H "Authorization: Bearer plata_..." -H "Content-Type: application/json" -d '{"type":"EXPENSE","amount":5,"account_id":"ID","note":"Café"}'Anotar una transferencia
curl -X POST https://plata.creceideas.com/api/v1/transfers -H "Authorization: Bearer plata_..." -H "Content-Type: application/json" -d '{"from_account_id":"ID","to_account_id":"ID","from_amount":10,"to_amount":8900}'Cuotas
Se cuenta por llamadas, no por caracteres ni tokens: anotar un ingreso es una escritura, anotar un gasto es otra, y ver tus cuentas es una lectura. La API y el MCP gastan de la misma cuota.
- 100 escrituras al día y 1.500 al mes.
- 500 lecturas al día y 5.000 al mes.
- 30 llamadas por minuto, y 3 conexiones como máximo.
Errores
401: la clave no es válida o venció.403: hace falta Plus, o esa herramienta solo está en el MCP.429: te pasaste de la cuota o del límite por minuto; la respuesta dice cuál.