eBay API Entegrasyonunda Affiliate Parametre Sorunu ve Çözümü
Bir .NET geliştiricisi eBay API'si kullanırken, komisyon izleme parametrelerinin API tarafından sıklıkla göz ardı edildiğini fark etti. Araştırması .NET 10 ve Aspire ile yapılan çözüm, sorunun çözümünü ve veri tutarlılığını sağlamak için uyguladığı stratejileri detaylandırıyor.
Kilit noktalar
- .NET 10, Aspire ve Worker Service mimarisi kullanılarak harici API entegrasyonu geliştirildi.
- Affiliate izleme parametreleri sorgu dizesinde değil, `X-EBAY-C-ENDUSERCTX` HTTP başlığında bekliyordu.
- Postgres'te depolanan eski, hatalı verilerin arka plan (backfill) ile düzeltilmesi gerekliliği.
- Sürekli çalışan bir Worker servisinde API'nin tepkilerini takip etmek için `Interlocked` yapısı kullanıldı.
- Sadece 200 OK yanıtı yetmez; başarının yanıt gövdesinde doğrulanması gerektiği dersi çekildi.
- Çözüm mekanizmalarının sadece dışa dönük (outbound) yönlerde zorlanması prensibi uygulandı.
Yazar, eBay Browse API'sine gönderilen affiliate linklerinin ay boyunca çalışmadığını fark etti. İlk denemelerde, izleme parametrelerini sorgu dizesine eklemek sonuç vermese de, asıl çözüm API'nin bir HTTP başlığı aracılığıyla bağlam (context) beklediğini ortaya çıkardı. Bu, `X-EBAY-C-ENDUSERCTX` başlığını `affiliateCampaignId` parametresi ile ekleyerek çözüldü. Ancak, bu başlık eklendikten sonra Postgres gibi veritabanlarında depolanmış eski verilerin güncellenmesi ve bağlantı katmanının (HttpClient) düzgün yapılandırılması gibi ikincil sorunlarla baş edildi.
Ayrıca, API'nin sadece 200 OK dönmesinin yeterli olmadığını, gelen yanıtın gerçek bir başarı göstergesi olup olmadığını anlamak için kendi kontrol mekanizmasını tasarladı. Bu sistem, `Interlocked` gibi yapıları kullanarak süreç çapında bir bayrak (flag) ile her isteğin ilk kez yapıldığı yerde izleme başarılı mı diye log kaydı bırakıyor, böylece ileride benzer sorunlar anında tespit edilebiliyor. Bu yaklaşım, büyük dağıtık sistemlerde dış servis bağımlılıkları yönetimi için kritik bir ders sunuyor.
Gerçek dünyada kullanımı
- .NET ile bir e-ticaret veya ihaleler takibi platformunda affiliate bağlantı başarısızlıklarını tespit etmek.
- Dağıtılmış sistemlerde (Microservices) üçüncü parti API'lerde gönderilen parametrelerin doğru işlenip işlenmediğini izlemek.
- Stok veya fiyatlandırma verilerinin tutarlılığını korumak için dış servis çağrılarından gelen verileri dönüştürmek.
- Azure Background Services veya Worker Service kullanarak düzenli arama görevlerinde (polling) veriyi zenginleştirmek.
Neden önemli
Büyük dağıtılmış sistemler kurarken, üçüncü taraf API'lerin hata mesajları yerine sadece 200 OK döndüğünü varsaymak felakete yol açabilir; yanıtı derinlemesine doğrulayan mekanizmalar kurmak hayati önem taşır.