Dış API veya webhook entegrasyonum neden çalışmıyor?
Dış API ve webhook entegrasyonları, kimlik doğrulama sorunları, yanlış yapılandırma, desteklenmeyen işlemler, ağ sorunları ve sağlayıcı tarafı kısıtlamaları gibi çeşitli nedenlerden dolayı başarısız olabilir.
Belirli bir hatayı tanımlamak, sorunu çözmenin en etkili yoludur.
Yaygın API entegrasyon sorunları
1. Yanlış uç nokta URL'si.
Yapılandırılan URL geçersiz olabilir veya yanlış API ortamına referans verebilir.
2. Geçersiz kimlik bilgileri.
Bir API anahtarı, token veya diğer kimlik bilgileri süresi dolmuş, iptal edilmiş veya yanlış girilmiş olabilir.
3. Yetersiz izinler.
Dış hesap, talep edilen kaynağa veya işleme erişim iznine sahip olmayabilir.
4. Geçersiz istek formatı.
API, eksik parametreleri, yanlış veri türlerini veya desteklenmeyen istek yapılarını reddedebilir.
5. Hız sınırlaması.
Sağlayıcı, kullanım limitleri aşıldıktan sonra geçici olarak istekleri reddedebilir.
6. Dış hizmetin kullanılamaması.
Sağlayıcı bir kesinti veya performans düşüklüğü yaşıyor olabilir.
7. Desteklenmeyen entegrasyon işlevselliği.
Talep edilen işlem, yapılandırılan entegrasyon aracılığıyla mevcut olmayabilir.
Yaygın webhook sorunları
1. Yanlış varış URL'si.
2. Geçersiz veya eksik kimlik doğrulama.
3. Desteklenmeyen olay aboneliği.
4. Beklenmeyen yük yapısı.
5. Uç nokta yanıt hataları.
6. Teslimat zaman aşımı.
7. Tekrar eden olay teslimatı.
8. Sağlayıcının webhook yapılandırmasında değişiklikler.
Dış API'yi nasıl sorun giderebilirim
Adım 1: Başarısız olan işlemi tanımlayın.
Entegrasyonun tam olarak ne yapmaya çalıştığını belirleyin.
Adım 2: Uç noktayı kontrol edin.
URL'yi, HTTP yöntemini ve gerekli parametreleri doğrulayın.
Adım 3: Kimlik doğrulamayı gözden geçirin.
Kimlik bilgilerinin geçerli olduğunu ve gerekli izinlere sahip olduğunu onaylayın.
Adım 4: Yanıtı inceleyin.
HTTP durum kodunu ve mevcut hata ayrıntılarını gözden geçirin.
Adım 5: İstek formatını doğrulayın.
İsteği sağlayıcının API belgeleriyle karşılaştırın.
Adım 6: Sağlayıcı kullanılabilirliğini kontrol edin.
Dış hizmetin bir olay yaşayıp yaşamadığını belirleyin.
Adım 7: Kontrol edilen verilerle test edin.
Önemli üretim kayıtlarını etkilemeyen minimal bir istek kullanın.
Adım 8: İlgili Polyosync işlemini gözden geçirin.
Yürütme ayrıntıları mevcutsa, ilgili sonuç veya hata bilgilerini kontrol edin.
Webhook'u nasıl sorun giderebilirim
Adım 1: Kaynak olayın gerçekleştiğini doğrulayın.
Adım 2: Yapılandırılan varış URL'sini doğrulayın.
Adım 3: Sağlayıcının webhook teslimat geçmişini kontrol edin.
Adım 4: HTTP yanıt durumunu inceleyin.
Adım 5: Kimlik doğrulama veya imza doğrulamasını kontrol edin.
Adım 6: Yük formatını gözden geçirin.
Adım 7: Alıcı sistemin olayı desteklediğini doğrulayın.
Adım 8: Tam olay akışını tekrar test edin.
HTTP 401 ne anlama geliyor?
İstek geçerli kimlik doğrulama eksik olabilir.
HTTP 403 ne anlama geliyor?
Kimlik bilgileri geçerli olabilir, ancak talep edilen işleme erişim izni yoktur.
HTTP 429 ne anlama geliyor?
Dış hizmet bir hız limiti uyguluyor olabilir.
HTTP 500 veya 503 ne anlama geliyor?
Dış hizmet, bir iç sorun veya geçici bir kullanılabilirlik sorunu yaşıyor olabilir.
Bir webhook, amaçlanan iş operasyonunu tamamlamadan başarıyla teslim edilebilir mi?
Evet.
Bir olayı alma ve aşağı akış işlemesini başarıyla tamamlama ayrı sonuçlardır.
Polyosync Destek ile iletişime geçerken ne sağlamalıyım?
Şunları dahil edin:
1. Dış hizmetin adı.
2. Etkilenen çalışma alanı.
3. Amaçlanan API veya webhook işlemi.
4. Hatanın yaklaşık zamanı.
5. HTTP durum kodu, varsa.
6. İlgili hata mesajı.
7. Entegrasyonun daha önce çalışıp çalışmadığı.
8. Herhangi bir son yapılandırma değişikliği.
Parolalar, API anahtarları, bearer token'lar, imza gizlilikleri veya diğer gizli kimlik bilgilerini dahil etmeyin.
Tavsiye edilen yaklaşım
Bir seferde bir işlemi sorun gidermeye çalışın.
Birden fazla ayarı aynı anda değiştirmekten kaçının, çünkü bu temel sorunu tanımlamayı daha zor hale getirebilir.