Control de gastos e ingresos API

Control de gastos e ingresos API, Libro de Ingresos y Gastos gestiona sus registros desde tu propia app: listar, añadir, actualizar y eliminar. Los endpoints funcionan con una clave de API en lugar de una sesión de navegador.

Inicio rápido

Crea una clave en la sección API para desarrolladores de tu cuenta; la clave en texto sin formato solo se muestra al momento de crearla.
Envía la solicitud a https://api.pixepi.com con el encabezado Authorization: Bearer <key>.
Las respuestas devuelven JSON; en los endpoints de lista puedes usar los campos page, per_page y filtros.

Ejemplo de solicitud

curl -H "Authorization: Bearer $PIXEPI_KEY" "https://api.pixepi.com/api/v1/apps/gelir-gider-defteri/categories"

curl -X POST "https://api.pixepi.com/api/v1/apps/gelir-gider-defteri/categories" \
  -H "Authorization: Bearer $PIXEPI_KEY" \
  -d "kind=expense" \
  -d "name=Alquiler"

Endpoints de esta herramienta

Método	Ruta	Qué hace
`GET`	`/categories`	Lista las categorías (las del sistema compartidas y las tuyas).
`POST`	`/categories`	Añade una categoría nueva.
`POST`	`/categories/{id}`	Actualiza una categoría.
`POST`	`/categories/{id}/archive`	Archiva una categoría; llamarla de nuevo no cambia el estado.
`GET`	`/entries`	Lista los registros; filtra por fecha, tipo, categoría y nota.
`POST`	`/entries`	Añade un registro nuevo.
`POST`	`/entries/{id}`	Actualiza un registro.
`POST`	`/entries/{id}/delete`	Elimina un registro.
`GET`	`/summary`	Desglose del resumen: por mes, categoría o tipo.
`GET`	`/export.csv`	Exporta los registros en CSV.

Endpoints compartidos

Método	Ruta	Qué hace
`GET`	`/api/v1/apps`	Catálogo de la API
`GET`	`/api/v1/apps/gelir-gider-defteri`	Contrato de la herramienta
`GET`	`/api/v1/usage`	Resumen de uso
`GET`	`/api/v1/openapi.json`	Documento OpenAPI 3.1

Límites

El campo limit en las respuestas de lista incluye información de uso y tope.
La información del plan y la cuota está vinculada a tu cuenta; consulta el estado actual con GET /api/v1/usage.

Códigos de error

Código	Significado
`unauthorized`	Falta la clave API o no es válida.
`forbidden`	Esta operación no está permitida con esta clave.
`not_found`	Herramienta, tarea o registro no encontrado (404 también para acceso entre cuentas).
`invalid_input`	Error de validación en los datos de entrada (campo ausente o incorrecto, fecha no válida, etc.).
`invalid_request`	La solicitud tiene un formato incorrecto.
`too_large`	El tamaño del archivo o del cuerpo supera el límite.
`unsupported_media`	El tipo de archivo no es compatible.
`not_supported`	Esta herramienta no se puede ejecutar en este endpoint (app con estado).
`not_ready`	La tarea aún no ha terminado.
`expired`	El resultado ha caducado.
`no_output`	No hay ningún resultado disponible para descargar.
`invalid_path`	Ruta de salida no válida.
`quota_exceeded`	Límite de cuota o de frecuencia superado.
`rate_limited`	Demasiadas solicitudes en poco tiempo; espera un poco e inténtalo de nuevo.
`csrf`	Error en la verificación del formulario del navegador (la API externa usa claves).
`conflict`	La operación entra en conflicto con el estado actual.
`unavailable`	La herramienta no está disponible temporalmente.
`internal_error`	Error inesperado del servidor.

Documentos

Preguntas frecuentes

¿Dónde consigo una clave de API?

Crea una clave en la sección Developer API de tu cuenta; la clave solo se muestra una vez, al momento de crearla.

¿Cómo se envía una solicitud?

Los endpoints se ejecutan en https://api.pixepi.com; cada solicitud incluye el encabezado "Authorization: Bearer <key>".

¿Qué endpoints expone la API de Libro de Ingresos y Gastos?

La tabla anterior lista los endpoints declarados; todos funcionan con registros vinculados a tu cuenta y devuelven 404 para accesos entre cuentas.

¿Cómo se interpreta una respuesta de error?

El cuerpo del error contiene los campos {ok:false, error, code, request_id}; los valores de code están en la tabla de códigos de error.