Fedex Logo

İş Kuralları ve Doğrulama Süreci


  • Bir gönderi hesap numarası birden fazla Gelişmiş Entegre Görünürlük içinde kullanılamaz.
  • Müşteri tarafından oluşturulan hedef URL/uç nokta:
    • HTTPs uzantısına sahip olmalıdır.
    • POST isteklerine yanıt vermeli ve JSON yüklerini ayrıştırmalıdır.
    • Karakter sınırı 200'dür
    • URL'niz şunları içeriyorsa engellenir:
      • RFC1918 IP alanı
      • fedex.com veya alt alan adlarından herhangi biri
      • URL'deki IP adresleri (localhost, 127.0.0.1 dahil)

 

  • Gelişmiş Entegre Görünürlük Güvenliği: Yalnızca geçerli bir sertifika yetkilisinin (CA) sertifikasıyla yapılandırılmış TLS (SSL) 1.2 veya daha yüksek protokol sürümlerini kullanan HTTPS bağlantıları desteklenir. FedEx sunucularından herhangi bir aksaklık yaşamadan güncelleme almak için aşağıdaki IP adreslerini güvenli adresler listesine alın:
    Üretim

       Müşteriler şunları beyaz listeye ekleyebilir: "nat.fxconnect.eastus2.heap-prod.fedex.io"

       CIDR "20.65.16.22/31" kullanılıyor

  • Müşteriler bazen takip olayı güncellemelerini yanlış sırayla alabilirler ve doğru sıralama için tarama olayı zaman bilgisine bakmaları gerekir.
  • FedEx Developer Portal'da Hesabı/Hesapları Silme:
    • Aşağıdaki durumlarda Kullanıcı/Müşteri hesap silme işlemi yapamaz:
      1. Herhangi bir etkin Gelişmiş Entegre Görünürlük ile ilişkiliyse.
      2. Hesap kullanılabilir durumdaysa veya bir projeyle ilişkilendirilmişse.
      3. Bir projedeki/Gelişmiş Entegre Görünürlük içindeki tek hesapsa.
        Not: Kullanıcının/Müşterinin, hesabı öncelikle projeden/Gelişmiş Entegre Görünürlükten kaldırması ve ardından kuruluştan silmesi gereklidir.
    • Aşağıdaki durumlarda kullanıcı/müşteri hesap silme işlemi yapabilir:
      1. Hesap aynı kuruluşa ait olmalıdır.
      2. Kuruluştan hesap silebilmek için Kullanıcı/Müşteri yönetici olmalıdır.

Yaygın Kısıtlamalar

  • Faaliyet halindeki şirketlerin FedEx 9 haneli hesap numaralarıyla ilişkili tüm müşteri gönderileri (FedEx Express®, FedEx Ground® ve FedEx Ground® Economy [eski adıyla FedEx SmartPost®]) varış yeri veya menşe fark etmeksizin (gelen, giden, uluslararası, yurt içi, vb.) kapsam dahilindedir.
  • Gelişmiş Entegre Görünürlük web kancası yalnızca 9 haneli kurumsal/parsel destekli hesapları destekler. Kurumsal hesaplar, FedEx Express ve FedEx Ground dahil olmak üzere tüm FedEx İşletme Sermayeli Şirketleri ile ilişkili gönderilerin oluşturulmasını sağlar.

  • Not: 9 haneli yalnızca LTL kargo hesapları desteklenmez, LTL kargo hesabı eklemek istiyorsanız LTL'yi kurumsal hesaba taşımak için müşteri desteğiyle iletişime geçmeniz gerekir.
  • Müşteriler, kendilerine ulaşan gönderi takip olaylarının sırasını yönetmelidir.
  • Abone olunan Gelişmiş Entegre Görünürlük web kancası ile ilgili herhangi bir aktivite (Kaydedildi/Başarısız/Oluştur/Güncelle/İptal/Sil) olduğunda otomatik e-posta bildirimleri gönderilir.
  • Çeviriler:
    • Takip safi yük çevirileri 41 dilde (yerel dil) desteklenmektedir.(Yakında)
      Desteklenen dillerin listesini görüntülemek için buraya tıklayınız.
    • Şu anda takip safi yük çevirisi İngilizce (Amerika Birleşik Devletleri) dilinde desteklenmektedir.
    • E-posta bildirim çevirileri yalnızca ABD bölgeleri tarafından desteklenen diller için sunulmaktadır. (Yerel dil: en-US, es-US)

 


FedEx Developer Portal Kullanıcı rolleri:


Yapılandırılan role bağlı olarak FedEx Developer Portal üzerinden belirli işlevleri gerçekleştirebilirsiniz.
FedEx Developer Portal hakkında daha fazla bilgi edinmek için Kuruluş Yönetimi Kılavuzu'na bakınız.

Gelişmiş Entegre Görünürlük Doğrulama Süreci

MAC/HMAC nedir ve doğrulama sürecinde nasıl kullanılır?

Mesaj kimliği doğrulama kodu (MAC), güvenilir olmayan bir ortam üzerinden iletilen veya böyle bir ortamda saklanan bilgilerin bütünlüğünü gizli bir anahtar kullanarak kontrol etmek için bir yol sağlar. MAC'ler genellikle iki taraf arasında iletilen bilgileri doğrulamak için ortak gizli anahtara sahip iki taraf arasında kullanılır.

Kriptografik karma işlevlerini temel alan MAC mekanizmaları HMAC olarak adlandırılır. HMAC, gizli bir ortak anahtar eşliğinde herhangi bir kriptografik karma işlevi (ör. SHA256) ile kullanılabilir. HMAC mekanizması RFC 2104'te belirtilmiştir. FedEx Gelişmiş Entegre Görünürlük web kancası HMAC SHA256 kullanacaktır.

SHA256(güvenlik belirteci + safi yük) =  Safi yük Başlığının bir parçası olarak Base 64 kodlu fdx imzası

Örnek (HMAC SHA256 karma işlevini göstermeye yönelik bir sözde kod parçası):

  • İlk olarak HmacSHA256 algoritmasını ve gizli anahtar olarak güvenlik belirtecini kullanarak MAC'yi başlatın.
  • Ardından FedEx tarafından gönderilen istek yükünü onaltılık biçimde kodlayarak MAC işlemini tamamlayın.
  • Bu son karma işlevi, FedEx tarafından gönderilen anlık bildirimdeki fedex-signature başlığının değeriyle eşleşmelidir.

Mac mac = Mac.getInstance("HmacSHA256"); 

mac.init(new SecretKeySpec(secureToken.getBytes(), "HmacSHA256")); 

return new String(Base 64 encoded(mac.doFinal(payLoad.getBytes()))); 

Not: Kullanılan gizli anahtar, Gelişmiş Entegre Görünürlük ayarlarını yaparken veya Gelişmiş Entegre Görünürlük URL'sini test ederken sağlayacağınız güvenli belirteçtir.

 

Gecikme Hesaplama

 

Olay Oluşturma Zamanı, bir olayın ağda gerçekten ne zaman meydana geldiğini gösterir.
Olay sisteme kaydedilinceye kadar (Mesaj Oluşturma Zaman Damgası ile belirtilir) ne web kancaları ne de başka bir sistem bunu işleyemez veya teslim edemez.

Öneri

Müşteriler, olayın dijital sistemlere ne zaman sunulduğunu en iyi şekilde temsil ettiği için gecikmeyi ölçmek amacıyla Mesaj Oluşturma Zaman Damgası'nı kullanmalıdır. Bu zaman damgası, FedEx'in dijitall güncellemelerinin zamanlamasıyla büyük ölçüde uyumludur ve genellikle fedex.com'da görünen güncellemelerden daha hızlıdır ya da bunlarla neredeyse aynıdır.

 

Doğrulama Kuralları: 

  • Gelişmiş Entegre Görünürlük web kancası Adı benzersiz olmalıdır.
  • Gelişmiş Entegre Görünürlük web kancası Hedef URL'si, Standartlaştırılmış Söz Dizimi biçiminde olmalıdır.
  • Gelişmiş Entegre Görünürlük web kancası oluşturmak için gerekli tüm alanların doldurulması gerekir.
  • Bir Gelişmiş Entegre Görünürlük web kancası  oluşturmak için en az bir kullanılabilir FedEx gönderi hesap numarası ilişkilendirilmelidir.
  • Başarılı doğrulama için:
    • Bir Gelişmiş Entegre Görünürlük web kancası başarıyla oluşturulduğunda bir onay mesajı alırsınız.

      Örnek Onay Mesajı: <<Gelişmiş Entegre Görünürlük web kancası adı>> başarıyla oluşturuldu. Değişikliklerin geçerli olması 10 dakikayı bulabilir.

  • Başarısız/Geçersiz doğrulama için:
    • FedEx, 200 (Tamam) veya 202 (Kabul Edildi) dışında bir yanıt alırsa Gelişmiş Entegre Görünürlük web kancası hedef URL'sinin doğrulanması işleminin başarısız olduğu kabul edilir.
CLOSE

Response

Copy