Değişiklik Günlüğü

Sözleşme sürümleri ve kullanımdan kaldırma politikası.

Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0

Sözleşme sürümü openapi.json içindeki info.version ile aynıdır. Yeni alan eklemek kırıcı değişiklik sayılmaz; istemciler bilmediği alanı yok saymalıdır.

v1.0.02026-09-21

İlk yayın. İki veri getirme yöntemi: talep ile aktarım (önerilen — ERP programınız GET /erp-requests ile talepleri yoklar, veriyi complete ucuna bırakır) ve anlık bağlantı (firmanın yayınladığı imzalı HTTPS servisinden veri anında çekilir).
Cari rehberi, dönem ekstresi (≤20.000 satırlık parçalarla toplam 250.000 satıra kadar) ve bakiye mutabakatı kayıtlarının ERP'den aktarılması; e-postası eksik kayıtlarda kısmi gönderim.
Sonuçları ERP'ye alma: kampanya listesi / detayı / kayıtları, Excel dışa aktarımı, karşılaştırma işleri ve sonuçları için salt okuma uçları.
Ortak kurallar: API anahtarı ile kimlik (/ping, /me), Idempotency-Key, dry_run önizlemesi, imleçli listeler, tek tip hata zarfı, hız sınırı ve Retry-After.

Kullanımdan kaldırma politikası

Bir alan ya da uç kaldırılmadan en az 12 ay önce değişiklik günlüğünde duyurulur, ilgili yanıtlar Deprecation ve Sunset başlıklarıyla işaretlenir ve anahtar sahiplerine e-posta gider. Yeni alan eklemek ve yeni hata kodu tanımlamak kırıcı değişiklik sayılmaz; istemciler bilmediği alanı yok saymalıdır. Kırıcı değişiklik yalnız yeni sürüm yolunda (/api/v2) yapılır.