@noway · 7 gün önce
Kargo etiketlerini toplu basan aracı ajanla yazdırdım; API belgesi eski çıkınca neler yaptım
E-ticaret işimde günde 60 ile 120 arası sipariş çıkıyor. Kargo firmasının panelinden etiketleri tek tek oluşturmak sabahın ilk bir buçuk saatini yiyordu. Pazaryerinin entegrasyonu bir kısmını çözüyordu ama kendi sitemizden gelen siparişler için yine elle iş vardı. Geçen ay bir kodlama ajanıyla kendi küçük aracımı yazdırmaya karar verdim: sitenin sipariş listesini çeksin, kargo firmasının servisine göndersin, dönen barkodlarla etiketleri tek bir PDF olarak versin.
Ajan ilk taslağı çok çabuk çıkardı. Sorun, kargo firmasının bana verdiği API belgesinin eski olmasıydı. Belgede yazan alan adlarının bir kısmı servis tarafında değişmişti, ajan da doğal olarak belgeye göre kod yazdı. Gelen hata mesajları da pek açıklayıcı değildi. İlk gün ajan hata mesajına bakıp her seferinde başka bir alan adını tahmin etmeye başladı ve bu, kısır bir döngüye dönüştü.
Döngüyü kırmak için yaptıklarım:
1. Ajana tahmin yürütmeyi bırakmasını, her denemeyi ve dönen cevabı bir dosyaya kaydetmesini söyledim. Böylece neyin denendiğini görebildim.
2. Kargo firmasının entegrasyon destek hattını aradım. Güncel örnek istek gönderdiler, bu tek dosya bir günlük uğraştan daha değerliydi.
3. Örnek isteği olduğu gibi test ortamına gönderip çalıştığını gördükten sonra ajana bunu referans verdim.
4. Test ortamında yirmi farklı adres tipiyle denedim: köy adresleri, apartman adı uzun olanlar, posta kodu eksik olanlar. İki adres tipinde servis hata dönüyordu, ajanın bunlar için bir uyarı ekranı yapmasını istedim.
Sonuçta araç şimdi sabah 15 dakikada tüm etiketleri basıyor. Ama ilk haftayı canlıya almadan, eski yöntemle yan yana çalıştırarak geçirdim. Bir kere ilçe bilgisi yanlış eşlendiği için bir paketin etiketi başka ilçeye basıldı, o hafta yakaladık.
Lojistik tarafında ajanla iş yapacak olana tavsiyem: entegrasyon belgesine körü körüne güvenmeyin ve gerçek bir örnek isteği elde etmeden işe başlamayın. Ajan belgeye ne kadar sadıksa, belge yanlışsa o kadar emin bir şekilde yanlış kod yazıyor.
Ajan ilk taslağı çok çabuk çıkardı. Sorun, kargo firmasının bana verdiği API belgesinin eski olmasıydı. Belgede yazan alan adlarının bir kısmı servis tarafında değişmişti, ajan da doğal olarak belgeye göre kod yazdı. Gelen hata mesajları da pek açıklayıcı değildi. İlk gün ajan hata mesajına bakıp her seferinde başka bir alan adını tahmin etmeye başladı ve bu, kısır bir döngüye dönüştü.
Döngüyü kırmak için yaptıklarım:
1. Ajana tahmin yürütmeyi bırakmasını, her denemeyi ve dönen cevabı bir dosyaya kaydetmesini söyledim. Böylece neyin denendiğini görebildim.
2. Kargo firmasının entegrasyon destek hattını aradım. Güncel örnek istek gönderdiler, bu tek dosya bir günlük uğraştan daha değerliydi.
3. Örnek isteği olduğu gibi test ortamına gönderip çalıştığını gördükten sonra ajana bunu referans verdim.
4. Test ortamında yirmi farklı adres tipiyle denedim: köy adresleri, apartman adı uzun olanlar, posta kodu eksik olanlar. İki adres tipinde servis hata dönüyordu, ajanın bunlar için bir uyarı ekranı yapmasını istedim.
Sonuçta araç şimdi sabah 15 dakikada tüm etiketleri basıyor. Ama ilk haftayı canlıya almadan, eski yöntemle yan yana çalıştırarak geçirdim. Bir kere ilçe bilgisi yanlış eşlendiği için bir paketin etiketi başka ilçeye basıldı, o hafta yakaladık.
Lojistik tarafında ajanla iş yapacak olana tavsiyem: entegrasyon belgesine körü körüne güvenmeyin ve gerçek bir örnek isteği elde etmeden işe başlamayın. Ajan belgeye ne kadar sadıksa, belge yanlışsa o kadar emin bir şekilde yanlış kod yazıyor.
5 2 yorum
