{"openapi":"3.1.0","info":{"title":"pixepi API","version":"1.0.0","description":"pixepi araçları için dış geliştirici API'si. Kimlik: Authorization: Bearer <anahtar>."},"servers":[{"url":"https://api.pixepi.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"pixepi hesabından üretilen API anahtarı."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string"},"code":{"type":"string"},"request_id":{"type":"string"}},"required":["ok","error","code"]},"Job":{"type":"object","properties":{"id":{"type":"integer"},"app":{"type":"string"},"status":{"type":"string","enum":["queued","processing","done","failed"]},"progress":{"type":"integer"},"download_url":{"type":"string"}}}}},"paths":{"/api/v1/apps":{"get":{"summary":"Araç kataloğu","security":[],"responses":{"200":{"description":"Araç listesi"}}}},"/api/v1/apps/{slug}":{"get":{"summary":"Araç sözleşmesi","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Girdi/çıktı/seçenek sözleşmesi"}}}},"/api/v1/apps/{slug}/run":{"post":{"summary":"Aracı çalıştır","description":"Dosya girdisi multipart/form-data ile gönderilir; seçenekler options[alan] biçimindedir. Metin girdisi aynı formda ya da {\"input\":\"...\",\"options\":{...}} JSON gövdesiyle taşınır.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"İş tamamlandı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Kota/hız sınırı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/jobs/{id}":{"get":{"summary":"İş durumu","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"İş durumu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}}}}}},"/api/v1/jobs/{id}/download":{"get":{"summary":"İş çıktısını indir","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Dosya"}}}},"/api/v1/usage":{"get":{"summary":"Kullanım özeti","responses":{"200":{"description":"Kota kullanımı"}}}},"/api/v1/apps/gelir-gider-defteri/kategoriler":{"get":{"summary":"Kategorileri listeler (ortak sistem kategorileri + kendi kategorilerin).","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Yeni kategori ekler.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object"}}}}}},"/api/v1/apps/gelir-gider-defteri/kategoriler/{id}":{"post":{"summary":"Kategoriyi günceller.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object"}}}}}},"/api/v1/apps/gelir-gider-defteri/kategoriler/{id}/arsivle":{"post":{"summary":"Kategoriyi arşivler; ikinci çağrı durumu değiştirmez.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object"}}}}}},"/api/v1/apps/gelir-gider-defteri/entries":{"get":{"summary":"Kayıtları listeler; tarih, tür, kategori ve nota göre filtreler.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Yeni kayıt ekler.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object"}}}}}},"/api/v1/apps/gelir-gider-defteri/entries/{id}":{"post":{"summary":"Kaydı günceller.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object"}}}}}},"/api/v1/apps/gelir-gider-defteri/entries/{id}/sil":{"post":{"summary":"Kaydı siler.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object"}}}}}},"/api/v1/apps/gelir-gider-defteri/ozet":{"get":{"summary":"Özet kırılımı: ay, kategori ya da tür.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/apps/gelir-gider-defteri/disa-aktar.csv":{"get":{"summary":"Kayıtları CSV olarak dışa aktarır.","responses":{"200":{"description":"Başarılı"},"401":{"description":"Kimlik yok/geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Kayıt bulunamadı (çapraz erişimde de 404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Girdi hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"x-apps":[{"slug":"kargo-label","name":"KargoLabel","runnable":true,"run_url":"https://api.pixepi.com/api/v1/apps/kargo-label/run","endpoints":[],"docs_url":"https://kargolabel.pixepi.com/api-dokumani","input":{"type":"file","name":"file","accept":[".pdf"],"mime":["application/pdf"],"multiple":true,"label":"Kargo etiketlerini buraya bırak","hint":"Pazaryeri panelinden indirdiğin A4 PDF'ler · her biri en fazla 100 MB","required":true,"placeholder":""},"options":[{"key":"format","type":"radio","label":"Çıktı boyutu","default":"100x150","choices":[{"value":"100x150","label":"100 × 150 mm","hint":"En yaygın kargo etiketi ölçüsü."},{"value":"80x120","label":"80 × 120 mm","hint":"Kompakt etiket"}],"min":null,"max":null},{"key":"crop","type":"select","label":"Etiket alanı","default":"sol-ust","choices":[{"value":"sol-ust","label":"Sol üst köşe","hint":"Standart pazaryeri düzeni"},{"value":"tam-sayfa","label":"Tam sayfa (A4'ü sığdır)","hint":"Etiket sayfanın tamamına yayılmışsa"},{"value":"ust-yari","label":"Üst yarı","hint":"Etiket üst yarıdaysa"},{"value":"orta","label":"Ortadan 100 × 150","hint":"Etiket ortadaysa"}],"min":null,"max":null}],"batch":{"mode":"files","columns":[]},"output":{"type":"file","mime":"application/pdf","ext":"pdf","label":"Etiketleri indir"},"max_upload_mb":100},{"slug":"gelir-gider-defteri","name":"Gelir-Gider Defteri","runnable":false,"run_url":null,"endpoints":[{"method":"GET","path":"/kategoriler","summary":"Kategorileri listeler (ortak sistem kategorileri + kendi kategorilerin).","write":false},{"method":"POST","path":"/kategoriler","summary":"Yeni kategori ekler.","write":true},{"method":"POST","path":"/kategoriler/{id}","summary":"Kategoriyi günceller.","write":true},{"method":"POST","path":"/kategoriler/{id}/arsivle","summary":"Kategoriyi arşivler; ikinci çağrı durumu değiştirmez.","write":true},{"method":"GET","path":"/entries","summary":"Kayıtları listeler; tarih, tür, kategori ve nota göre filtreler.","write":false},{"method":"POST","path":"/entries","summary":"Yeni kayıt ekler.","write":true},{"method":"POST","path":"/entries/{id}","summary":"Kaydı günceller.","write":true},{"method":"POST","path":"/entries/{id}/sil","summary":"Kaydı siler.","write":true},{"method":"GET","path":"/ozet","summary":"Özet kırılımı: ay, kategori ya da tür.","write":false},{"method":"GET","path":"/disa-aktar.csv","summary":"Kayıtları CSV olarak dışa aktarır.","write":false}],"docs_url":"https://defter.pixepi.com/api-dokumani","input":{"type":"file","name":"file","accept":[],"mime":[],"multiple":false,"label":"","hint":"","required":true,"placeholder":""},"options":[],"batch":{"mode":"files","columns":[]},"output":{"type":"file","mime":"application/octet-stream","ext":"bin","label":"Sonucu indir"},"max_upload_mb":100},{"slug":"gorsel-kucult","name":"GörselKüçült","runnable":true,"run_url":"https://api.pixepi.com/api/v1/apps/gorsel-kucult/run","endpoints":[],"docs_url":"https://gorselkucult.pixepi.com/api-dokumani","input":{"type":"file","name":"file","accept":[".jpg",".jpeg",".png",".webp"],"mime":["image/jpeg","image/png","image/webp"],"multiple":true,"label":"Görselleri buraya bırak","hint":"JPG, PNG ya da WebP · her biri en fazla 100 MB","required":true,"placeholder":""},"options":[{"key":"quality","type":"range","label":"Kalite","default":82,"choices":[],"min":40,"max":95},{"key":"max_side","type":"number","label":"Uzun kenar sınırı (isteğe bağlı)","default":"","choices":[],"min":0,"max":6000},{"key":"format","type":"radio","label":"Çıktı biçimi","default":"same","choices":[{"value":"same","label":"Aynı biçim","hint":"Yüklediğin dosya türü korunur"},{"value":"jpeg","label":"JPG","hint":"En küçük boyut, fotoğraflar için"},{"value":"webp","label":"WebP","hint":"Aynı kalitede daha küçük dosya"},{"value":"png","label":"PNG","hint":"Saydamlık korunur, boyut büyür"}],"min":null,"max":null},{"key":"auto_rotate","type":"switch","label":"Telefon yönünü otomatik düzelt","default":true,"choices":[],"min":null,"max":null}],"batch":{"mode":"files","columns":[]},"output":{"type":"zip","mime":"application/zip","ext":"zip","label":"Görselleri indir"},"max_upload_mb":100}]}