Einnahmen- und Ausgabenrechner API

Einnahmen- und Ausgabenrechner API, verwaltet Einnahmen-Ausgaben-Buch seine Einträge aus deiner eigenen App heraus: auflisten, hinzufügen, aktualisieren und löschen. Die Endpunkte nutzen einen API-Schlüssel statt einer Browser-Sitzung.

Schnellstart

Erstelle einen Schlüssel im Bereich Entwickler-API deines Kontos; der Klartext-Schlüssel wird nur bei der Erstellung angezeigt.
Sende die Anfrage an https://api.pixepi.com mit dem Header Authorization: Bearer <key>.
Antworten liefern JSON; bei Listen-Endpunkten kannst du die Felder page, per_page und Filterfelder verwenden.

Beispielanfrage

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=Miete"

Endpunkte dieses Werkzeugs

Methode	Pfad	Funktion
`GET`	`/categories`	Listet Kategorien auf (Standardkategorien plus eigene).
`POST`	`/categories`	Erstellt eine neue Kategorie.
`POST`	`/categories/{id}`	Aktualisiert eine Kategorie.
`POST`	`/categories/{id}/archive`	Archiviert eine Kategorie; erneuter Aufruf ändert den Status nicht.
`GET`	`/entries`	Listet Einträge auf; filtert nach Datum, Art, Kategorie und Notiz.
`POST`	`/entries`	Erstellt einen neuen Eintrag.
`POST`	`/entries/{id}`	Aktualisiert einen Eintrag.
`POST`	`/entries/{id}/delete`	Löscht einen Eintrag.
`GET`	`/summary`	Übersichtsaufschlüsselung: nach Monat, Kategorie oder Art.
`GET`	`/export.csv`	Exportiert Einträge als CSV.

Gemeinsame Endpunkte

Methode	Pfad	Funktion
`GET`	`/api/v1/apps`	API-Katalog
`GET`	`/api/v1/apps/gelir-gider-defteri`	Werkzeug-Vertrag
`GET`	`/api/v1/usage`	Nutzungsübersicht
`GET`	`/api/v1/openapi.json`	OpenAPI-3.1-Dokument

Limits

Das Feld limit in Listenantworten enthält Angaben zu Nutzung und Höchstgrenzen.
Kontingent- und Tarifinformationen sind an dein Konto gebunden; prüfe den aktuellen Status mit GET /api/v1/usage.

Fehlercodes

Code	Bedeutung
`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig.
`forbidden`	Dieser Vorgang ist mit diesem Schlüssel nicht erlaubt.
`not_found`	Werkzeug, Job oder Datensatz nicht gefunden (404 auch bei kontoübergreifendem Zugriff).
`invalid_input`	Eingabe ungültig (fehlendes oder fehlerhaftes Feld, ungültiges Datum usw.).
`invalid_request`	Die Anfrage ist fehlerhaft.
`too_large`	Datei oder Anfrage übersteigt das Limit.
`unsupported_media`	Dateityp wird nicht unterstützt.
`not_supported`	Dieses Werkzeug kann auf diesem Endpunkt nicht ausgeführt werden (stateful App).
`not_ready`	Der Job ist noch nicht fertig.
`expired`	Das Ergebnis ist abgelaufen.
`no_output`	Für diesen Job ist kein Download verfügbar.
`invalid_path`	Ungültiger Ausgabepfad.
`quota_exceeded`	Kontingent oder Anfragelimit überschritten.
`rate_limited`	Zu viele Anfragen in kurzer Zeit. Warte kurz und versuche es erneut.
`csrf`	Formularüberprüfung im Browser fehlgeschlagen (die externe API nutzt Schlüssel).
`conflict`	Der Vorgang steht in Konflikt mit dem aktuellen Status.
`unavailable`	Das Werkzeug ist vorübergehend nicht verfügbar.
`internal_error`	Unerwarteter Serverfehler.

Dokumente

Häufig gestellte Fragen

Woher bekomme ich einen API-Schlüssel?

Erstelle einen Schlüssel im Bereich Entwickler-API deines Kontos. Der Schlüssel wird nur einmalig bei der Erstellung angezeigt.

Wie wird eine Anfrage gesendet?

Die Endpunkte laufen unter https://api.pixepi.com; jede Anfrage enthält den Header "Authorization: Bearer <key>".

Welche Endpunkte stellt die Einnahmen-Ausgaben-Buch-API bereit?

Die obige Tabelle listet alle deklarierten Endpunkte auf. Alle arbeiten mit Einträgen deines Kontos und geben bei kontoübergreifendem Zugriff einen 404 zurück.

Wie lese ich eine Fehlerantwort?

Der Fehler-Body enthält die Felder {ok:false, error, code, request_id}; die Code-Werte findest du in der Fehlercode-Tabelle.