Sandbox Console
Web Kancasını Test Etme
Hedef URL'ye (alıcı/dinleyici sunucu) geri gönderilen takip verilerinin türünü test etmek için Web Kancası URL'sini Test Et özelliğini kullanabilirsiniz. Bu özellik, bir Gelişmiş Entegre Görünürlük web kancası oluşturulmadan önce URL'nin ve döndürülen verilerin doğrulanmasına yardımcı olur.
Sayfaya gitme:
Aşağıdaki adımları izleyerek Web Kancası URL'sini Test Et Korumalı Alan Konsoluna gidebilirsiniz:
- Projelerim (soldaki Gezinme Panelinde) -> Gelişmiş Entegre Görünürlük sekmesi -> Web kancası URL'sini Test Edin Düğmesi->Korumalı Alan Konsolundaki Bu Gelişmiş Entegre GörünürlüğüDeneyin seçeneğine tıklayın
- API Kataloğu (soldaki Gezinme Panelinde) -> Gelişmiş Entegre Görünürlük için arama yapın/ FİLTRELER -> Gelişmiş Entegre Görünürlük kartında Gelişmiş Entegre Görünürlük seçeneğine tıklayın:
- -> Genel Bakış -> Belgeler düğmesi -> Korumalı Alan Konsolu içinde Bu Gelişmiş Entegre Görünürlüğü Dene üzerine tıklayın.
- -> Belgeler -> Korumalı Alan Konsolundaki Bu Gelişmiş Entegre Görünürlüğü deneyin seçeneğine tıklayın.
Adımlar:
Aşağıdaki adımları izleyerek Web Kancası URL'sini Test Et işlevini kullanabilirsiniz:
- Web Kancası URL'sini Test Et düğmesine tıklayın.
- Aşağıdaki Test parametrelerini giriniz:
Alan Adı Açıklama Hedef URL'si
Bu URL ile Takip olayı verileri/yükü alınır.
- Müşterinin çalışan ve geçerli olan bir hedef URL sağlaması gerekir.
- Belirtilen hedef URL, standartlaştırılmış söz dizimi biçiminde olmalıdır (güvenli https URL'si).
Güvenlik Belirteci
Gelişmiş Entegre Görünürlük web kancası yanıtının kimliğini doğrulamak ve onaylamak için paylaşımlı gizli bilgi olarak kullanılır.
- Belirteç değeri minimum 26 ile maksimum 100 karakter uzunluğunda olmalıdır.
- En az 1 büyük harf, 1 küçük harf ve 1 rakam gereklidir.
- Güvenlik Belirteci, yanıt doğrulaması için Karma İşlev Tabanlı Mesaj Kimliği Doğrulama Kodu (HMAC) imzası oluşturmak amacıyla kullanılır.
Yük dili
Açılan listeden takip verileri çevirileri için tercih edilen dili seçin. Mevcut 6 örnek dil aşağıda belirtilmiştir:
- İngilizce (ABD)(Varsayılan)
Takip Türü
Takip verilerinin alınması gereken yanıt türünü seçiniz.
- Ayrıntılı Takip Yanıtı (Yanıt türü, olay geçmişinin tamamıyla güvenli takip verilerinden oluşur).(Varsayılan)
- Olaya Özel Takip Yanıtı (Yanıt türü, yalnızca en yakın tarihli olay bilgilerini içeren güvenli takip verilerinden oluşur).(Yakında)
Takip olayları
Paket yaşam döngüsündeki gönderi olaylarıyla ilgili e-posta bildirimleri almak için bir tane üst düzey kategori seçin. Üst düzey kategoriler aşağıda belirtilmiştir:
- Gönder
- Yolda
- Teslimat
- İstisnalar
- Tahmini Teslimat
Durum Olayı
Paketlerin yaşam döngüsündeki bir takip olayı. Alınacak takip olaylarından birini seçiniz. Mevcut 10 örnek durum olayları aşağıda belirtilmiştir:
- Paket alındı
- Taşınma durumunda
- Teslim edildi
- Teslimat İstisnası
Not: "Durum Olayı" alan değerleri, seçilen "Takip Olayı Kategorisi" temel alınarak doldurulur. "Takip Olayı Kategorisi" ve ilgili "Durum Olayları" hakkında daha fazla bilgi edinmek için aşağıdaki tabloya bakınız.
Durum Olay Kategorisi Durum Olayı Gönder
- Paket alındı
Yolda
- Taşınma durumunda
Teslimat
- Teslim edildi
İstisnalar
- Teslimat İstisnası
Tahmini Teslimat(Yakında)
- Tahmini Teslimat Tarihi (EDD)
- Tahmini Teslimat Zaman Aralığı (EDTW)
- Lisans Sözleşmesini İmzalamak/Kabul Etmek için FedEx Developer Portal Lisans Sözleşmesi (FDPLA) kutucuğunu işaretleyin.
- Test sonuçlarını görüntülemek için GÖNDER (PUSH) düğmesine tıklayın.
Yanıt:
Korumalı Alandaki yanıt parametreleri aşağıda belirtilmiştir:
- Gövde – Gövde, Korumalı Alan Konsolundaki Web Kancası URL'sini Test Et sekmesinde yer alan yanıt parametrelerini içerir.
- Durum – Test Sonuçları sekmesindeki bu bölümde, işleme alınan isteğin durumu gösterilir.
Örnek Başarı Mesajı:
Başarılı
Gelişmiş Entegre Görünürlüğü Test Et takip olayı ayrıntıları başarıyla gönderildi.
Status
Success
Test webhook tracking event details delivered successfully
Error
Test webhook tracking event details delivery failed
Test olayı teslimatı başarısız olursa DURUM ilgili hata kodu ve hata mesajıyla birlikte Test Sonuçları sekmesinde Hata olarak görüntülenir.
Örnek Hata Mesajı:
Hata Kodu:<<hata kodu>>
Gelişmiş Entegre Görünürlüğü Test Et takip olayı ayrıntıları gönderilemedi.
Doğrulama Kuralları:
- Gelişmiş Entegre Görünürlük URL'si Standartlaştırılmış Söz Dizimi biçiminde olmalıdır.
- Bir Gelişmiş Entegre Görünürlük URL'sini test etmek için gerekli olan alanların tümü doldurulmalıdır.
- Başarılı Doğrulama için:
- FedEx, JSON biçiminde örnek olay içeren bir istek gönderir. Not: Gelişmiş Entegre Görünürlük hedef URL'si, FedEx'e HTTP durum kodu olarak 200 (Tamam) yanıtını vermelidir.
- Başarısız/Geçersiz Doğrulama için:
- FedEx, 200 (Tamam) dışında bir yanıt alırsa Gelişmiş Entegre Görünürlük Hedef URL'sinin doğrulanması işleminin başarısız olduğu kabul edilir.
- FedEx, Test Sonuçları sekmesinde hata kodunu ve hata mesajını iletecektir
Veri Yükü Hesaplayıcı
Veri Yükü Hesaplayıcısı, abonelerin web kancası etkinliği yoluyla üretilen veri hacmini tahmin etmelerine yardımcı olmak için tasarlanmıştır. Günlük safi yük boyutlarına, gönderi sayılarına ve takip olaylarına ilişkin görünürlük sağlayarak kullanıcıların veri kullanımı ve entegrasyon planlaması konusunda bilinçli kararlar almalarına yardımcı olur.
Hesaplayıcıyı Kullanma
Kullanıcılar aşağıdaki parametreleri girebilir:
- Gönderi Sayısı
- Gönderi Başına Olay Sayısı (varsayılan: 5)
- Günlük Safi Yükün Hacmi (otomatik hesaplanır)
Hesaplayıcı, bu girdileri temel alarak dinamik bir şekilde şunları görüntüler:
- Toplam Takip Olayı Sayısı
- Günlük Safi Yük
- Tahmini Toplam Veri Boyutu
Bilgilendirme Notları:
- Gönderi Başına Olay Sayısı varsayılan olarak 5 olur. Bu, gönderi başına ortalama 17-18 olay ile hizmet türüne, taşıyıcıya ve varış noktasına bağlı olarak 1 ila 7 günlük tipik teslimat sürelerine dayanır. Ortalama teslimat süresinin 3 gün olduğu varsayılır. Not: Bu değer kullanıcı tarafından düzenlenebilir.
- Günlük Safi Yük Hacmi şu şekilde hesaplanır: Gönderi Sayısı × Gönderi Başına Olay Sayısı (varsayılan: 5)
- Kullanıcıların Gönderi Sayısını girmesi ve sonuçları oluşturmak için "HESAPLA" düğmesine tıklaması yeterlidir. Diğer değerler ya varsayılan değerlerdir ya da otomatik olarak hesaplanır.
Feragatname: Hesaplayıcının sağladığı tüm değerler yaklaşık değerlerdir ve yalnızca planlama amaçlıdır.
Number of Shipments
Events per Shipment (default 5)
Daily Payload Volume (events per day)
Note: Displayed values are approximations and may not reflect exact usage metrics.
