pixepi API

pixepi araçlarını kendi uygulamandan çağır: her araç aynı sürümlenmiş API yüzeyini (v1) paylaşır; kimlik Authorization: Bearer <anahtar> ile taşınır.

Hızlı başlangıç

Hesabındaki Geliştirici API'si bölümünden anahtar üret.
İsteği https://api.pixepi.com adresine Bearer başlığıyla gönder.
Uç sözleşmelerini katalogdan ya da OpenAPI belgesinden oku.

Araçlar

Araç	API yüzeyi	Doküman
KargoLabel	Dönüştürücü — `POST /run`	kargo-label
Gelir-Gider Defteri	10 uç (durum tutan app)	gelir-gider-defteri
GörselKüçült	Dönüştürücü — `POST /run`	gorsel-kucult

Ortak uçlar

Yöntem	Yol	Ne yapar
`GET`	`/api/v1/apps`	API kataloğu
`GET`	`/api/v1/apps/{slug}`	Araç sözleşmesi
`GET`	`/api/v1/jobs/{id}`	İş durumu
`GET`	`/api/v1/jobs/{id}/download`	İş çıktısını indirir
`GET`	`/api/v1/usage`	Kullanım özeti
`GET`	`/api/v1/openapi.json`	OpenAPI 3.1 belgesi

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ı.