Gelir gider defteri API'si

Gelir gider defteri API'si, Gelir-Gider Defteri kayıtlarını kendi uygulamandan yönetir: listele, ekle, güncelle ve sil. Uçlar tarayıcı oturumu yerine API anahtarıyla çalışır.

Hızlı başlangıç

Hesabındaki Geliştirici API'si bölümünden bir anahtar üret; düz metin anahtar yalnızca üretim anında gösterilir.
İsteği https://api.pixepi.com adresine Authorization: Bearer <anahtar> başlığıyla gönder.
Yanıtlar JSON döner; liste uçlarında page, per_page ve filtre alanlarını kullanabilirsin.

Örnek istek

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

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

Bu aracın uçları

Yöntem	Yol	Ne yapar
`GET`	`/kategoriler`	Kategorileri listeler (ortak sistem kategorileri + kendi kategorilerin).
`POST`	`/kategoriler`	Yeni kategori ekler.
`POST`	`/kategoriler/{id}`	Kategoriyi günceller.
`POST`	`/kategoriler/{id}/arsivle`	Kategoriyi arşivler; ikinci çağrı durumu değiştirmez.
`GET`	`/entries`	Kayıtları listeler; tarih, tür, kategori ve nota göre filtreler.
`POST`	`/entries`	Yeni kayıt ekler.
`POST`	`/entries/{id}`	Kaydı günceller.
`POST`	`/entries/{id}/sil`	Kaydı siler.
`GET`	`/ozet`	Özet kırılımı: ay, kategori ya da tür.
`GET`	`/disa-aktar.csv`	Kayıtları CSV olarak dışa aktarır.

Ortak uçlar

Yöntem	Yol	Ne yapar
`GET`	`/api/v1/apps`	API kataloğu
`GET`	`/api/v1/apps/gelir-gider-defteri`	Araç sözleşmesi
`GET`	`/api/v1/usage`	Kullanım özeti
`GET`	`/api/v1/openapi.json`	OpenAPI 3.1 belgesi

Sınırlar

Liste yanıtlarındaki limit alanı kullanım ve üst sınır bilgisini taşır.
Kota ve plan bilgisi hesabına bağlıdır; güncel durumu GET /api/v1/usage ile görürsün.

Hata kodları

Kod	Anlamı
`unauthorized`	API anahtarı yok ya da geçersiz.
`forbidden`	Bu işlem bu anahtarla yapılamaz.
`not_found`	Araç, iş ya da kayıt bulunamadı (sahiplik çaprazında da 404).
`invalid_input`	Girdi doğrulamadan geçmedi (eksik/bozuk alan, geçersiz tarih…).
`invalid_request`	İstek biçimi hatalı.
`too_large`	Dosya ya da gövde boyut sınırını aştı.
`unsupported_media`	Dosya türü kabul edilmiyor.
`not_supported`	Bu araç bu uçla çalıştırılamaz (durum tutan app).
`not_ready`	İş henüz tamamlanmadı.
`expired`	Çıktının saklama süresi doldu.
`no_output`	İş için indirilecek çıktı yok.
`invalid_path`	Çıktı yolu geçersiz.
`quota_exceeded`	Kota ya da hız sınırı aşıldı.
`rate_limited`	Kısa sürede çok istek; biraz bekleyip tekrar dene.
`csrf`	Tarayıcı formu doğrulaması başarısız (dış API anahtar kullanır).
`conflict`	İşlem mevcut durumla çakıştı.
`unavailable`	Araç geçici olarak kapalı.
`internal_error`	Beklenmeyen sunucu hatası.

Dokümanlar

Sıkça sorulan sorular

API anahtarını nereden alırım?

Hesabındaki Geliştirici API'si bölümünden anahtar üretirsin; anahtar üretim anında bir kez gösterilir.

İstek nasıl gönderilir?

Uçlar https://api.pixepi.com adresinde çalışır; her isteğe "Authorization: Bearer <anahtar>" başlığı eklenir.

Gelir-Gider Defteri API'si hangi uçları açar?

Beyan edilen uçları yukarıdaki tablo listeler; tümü hesabına bağlı kayıtlarla çalışır ve çapraz erişimde 404 döner.

Hata yanıtı nasıl okunur?

Hata gövdesi {ok:false, error, code, request_id} alanlarını taşır; code değerleri hata kodları tablosundadır.