1. Yeterlilik almak için proje oluşturun
2. API'leri entegre edin ve uygulamanızı test edin
3. Projenizi üretim aşamasına taşıyın
4. Sertifikasyonunuzu tamamlayın

Kuruluşunuzun bir yöneticisi veya katılımcısı API Projesi Oluştur düğmesine tıklayarak bir API projesi oluşturabilir.

FedEx API'lerine neden erişmeniz gerektiğini başlamadan önce bize bildirmeniz gerekir. Bir menü açılarak size açılan listede seçenekler sunar. FedEx API'leri ile entegrasyon sağlamak için iş ihtiyaçlarınızı en iyi şekilde tanımlayan seçeneği belirlemelisiniz.

Kendinizi gönderici olarak tanımlıyorsanız projenizi oluşturmaya başlayabilirsiniz. Bu üç aşamalı bir süreçtir:

API'leri Seç

Projenize dahil etmek istediğiniz API'leri seçin. Seçtiğiniz API'lere bağlı olarak bazı ek seçimler yapmanız gerekebilir.

Takip API'sini seçerseniz şunları da yapmanız gerekir:

• Üretim anahtarınızla ilişkilendirmek için bir hesap numarası seçin.
• API kotalarını, işlem oran limitlerini ve API sertifikasyon ayrıntılarını gözden geçirin.
• İşlem kotanızı aşmanız durumunda sizi bilgilendirecek e-postaları almak isteyip istemediğinizi seçin.

Projeyi yapılandır

İsim ve gönderim yeri gibi bazı proje bilgilerini girin.

• Projenize, kuruluşunuza özel ayırt edilebilir bir ad verin
• Size bir test gönderi hesabı atayabilmemiz için gönderi yapmayı planladığınız ülkeleri seçin. Bir Avrupa ülkesinde yerel olarak paket gönderimini test etmek için her bir ülkeye yönelik ayrı bir test hesabınız olmalıdır. Daha sonra dilediğiniz zaman ülke ekleyip çıkarabilirsiniz.
• En yeni API güncellemeleri ve kesinti ile ilgili bilgiler hakkında bildirim almak için bildirim tercihlerinizi ayarlayabilirsiniz.

Ayrıntıları onaylayın

Proje ayrıntılarınızı gözden geçirip kurallar ve koşulları kabul edin.

• FedEx Developer Portal Lisans Sözleşmesini okuyup kabul edin ve uygulamanızı satmayı veya dağıtmayı amaçlamadığınızı teyit edin.
• "Oluştur" düğmesine tıkladığınızda bir onay ekranı göreceksiniz. Daha sonra test kimlik bilgilerinizi yeni projenizde görüntüleyebilirsiniz.

• Her biri API işlemiyle birlikte kullanılması gereken bir OAuth erişim belirteci isteyin. Belirteç sadece bir saatliğine geçerlidir. Bu nedenle oturum sona ermeden önce belirteci yenilemek için uygulamanızı programlanabilir bir biçimde kodlamanız gerekir. Daha fazla bilgi için API Kimlik Doğrulamasına bakın
• API'nizin nasıl kullanılacağını daha iyi anlayabilmek üzere her bir API'nin iş bağlamını okumak için API'lerinizin Belgelerine tıklayın. Ayrıca istediğiniz entegrasyonla eşleşen uç nokta için örnek isteklerini de gözden geçirebilirsiniz.
• Çağrılarınızı örnek isteklerde açıklandığı gibi bu uç noktalara uygulayın ve test kimlik bilgilerinizle yapılandırın.
• Aldığınız API çağrı yanıtlarının belgelerde gösterilenlerle eşleştiğini doğrulayın.
• Test kimlik bilgilerinizi ve FedEx test URL'lerini kullanarak FedEx test ortamındaki uygulamanızı test edin.

Projeyi yapılandır adımında:

• Anahtarınızı gerektiğinde yeniden adlandırabilirsiniz.
• Proje oluşturma akışının 1. adımında seçtiğiniz hesap numarasını gözden geçirin. Böylece projenizi üretim aşamasına taşıyabilirsiniz. Projeniz üretim aşamasına geçtikten sonra gerektiğinde daha fazla hesap ekleyebilirsiniz.

Proje anahtarlarını alma adımında:

• Üretim API anahtarınız ve üretim gizli anahtarınız gösterilecektir. Bunları güvenli bir yere kopyaladığınızdan emin olun.
• Üretim gizli anahtarınızın güvenliğini korumak için sadece bir kez gösteriyoruz. Bunu kaybederseniz yenisini oluşturabilirsiniz.
•  İleri seçeneğine tıklayın.

Şimdi Projeye genel bakış sayfasına geri yönlendirileceksiniz. Bu sayfada projenizle ilişkili daha fazla hesap ekleyebilirsiniz.

Projeye genel bakış sayfasında:

• Projenizle ilişkili daha fazla hesap eklemek için 3 dikey noktaya (diğer adıyla kebap menüye) tıklayın.
• Ardından, Düzenle'ye tıklayın.

Böylece, bu proje için üretim anahtarınızla ilişkilendirmek istediğiniz ek hesapları ekleyebileceğiniz API anahtarı sayfasına yönlendirilirsiniz.

1. Bazı API'ler üretim ortamımızda kullanılmak üzere gönderi etiketi sertifikasyonu gerektirir. Bu gereklilikle projenizdeki tüm API'ler için sertifikasyon sürecini tamamlayın.

1. Tüm API'ler onaylandıktan ve etkinleştirildikten sonra test URI'lerini, anahtarları ve gönderi hesabını üretim URI'leriyle, anahtarlarla ve gönderi hesaplarıyla değiştirerek API isteklerinizi güncelleyin.

2. Örnek verileri kullanarak üretim ortamında uygulamanızı tekrar test edin.

3. Yeni entegrasyonunuzun avantajlarından yararlanın!

Web kancası projesi oluşturmak için ön gereksinimler

1. Hedef uygulamanızda/platformunuzda geçerli bir URL oluşturun
2. Güvenlik belirteci oluştur
3. Web kancası URL'sini test edin
4. Hedef URL'yi doğrulayın

Web kancası projesi oluşturun

1. Yapılandırılmış yük bildirimlerini almak için bir web kancası projesi oluşturun

Web kancası projesi oluşturmak için ön gereksinimler

FedEx'ten kimlik doğrulama kodlarını/mesajlarını ve takip web kancası yükü bildirimlerini almak için hedef uygulamanızda/platformunuzda geçerli bir URL oluşturun.

URL gereksinimleri:

Bu güvenlik belirteci, siz (müşteri) ve FedEx arasında iletilen bilgileri doğrulamak ve onaylamak için gizli bir anahtar olarak kullanılabilir.

Güvenlik belirteci gereksinimleri:

• minimum 25 karakter ve maksimum 100 karakter uzunluğu
• 1 büyük harfli karakter
• 1 küçük harfli karakter
• 1 rakam

URL'nizi test etmek isteğe bağlıdır ve bu adım size yardımcı olabilir.

Test yaparak 1. adımda oluşturduğunuz URL'nin geçerli olup olmadığı hakkında daha sağlıklı fikir edinebilirsiniz. Bu sayede FedEx URL'nizi tanımlayabilir ve veri göndermek için URL'nizle bir bağlantı kurabilir. Ayrıca test yaparak uygulamanızda yer alan izleme verilerini işleyip işleyemediğinizi kontrol etmenize ve onaylamanıza yardımcı olabilecek örnek test verileri de elde edebilirsiniz. Ancak bu test URL'nizin doğrulanmasını sağlamaz.

Web kancası URL'nizi nasıl test edeceğinizi öğrenmek için web kancası belgelerimizi ziyaret edin.

HMAC SHA256 karma algoritma yöntemini kullanarak hedef URL'niz ile FedEx arasında iletilen bilgileri doğrulamak için bir kimlik doğrulama işlemi oluşturun.

1. Oluştur'a tıkladığınızda FedEx, talep alanında size gönderilen rastgele bir itiraz dizesi oluşturur. Sizin de bu itiraz dizesini yanıt alanında FedEx'e geri göndermeniz gerekir.

1. Karma imza oluşturmak üzere itiraz dizesini ve güvenlik belirtecini (veya gizli anahtarı) karma hale getirmek (veya birleştirmek) için HMAC SHA256 algoritmasını/prosedürünü kullanarak mesaj kimliği doğrulama kodunu (MAC) başlatın

1. FedEx'e yanıt yapısında challengeString ve challengeStringResponse ile birlikte ve HTTP durum kodu 200 (OK) veya 202 (ACCEPTED) ile yanıt verin.

1. FedEx itiraz dizesini ve itiraz dizesi yanıtını doğrulayacaktır.

• Yanıt alanı FedEx tarafından alındıktan sonra FedEx challengeString ve challengeStringResponse öğelerini (veya daha önce oluşturulan karma imzayı) sırasıyla FedEx tarafından oluşturulan challengeString ve karma imza ile karşılaştırarak doğrular.

• Hem "challengeString" hem de HMAC imzaları eşleşirse doğrulama ve iş akışı başarılı olmuştur. Aksi durumlarda doğrulama işlemi başarısız olur ve buna ilişkin bir hata mesajı görüntülenir.

Web kancası projesi oluşturun

Projelerim sayfasındaki Web kancaları sekmesine gidin.

Kuruluşunuzun bir yöneticisi veya katılımcısı Web Kancası Projesi Oluştur düğmesine tıklayarak bir web kancası projesi oluşturabilir.

FedEx web kancalarına neden erişmeniz gerektiğini başlamadan önce bize bildirmeniz gerekir. Bir menü açılarak size açılan listede seçenekler sunar. FedEx web kancaları ile entegrasyon sağlamak için iş ihtiyaçlarınızı en iyi şekilde tanımlayan seçeneği belirlemelisiniz.

Kendinizi gönderici olarak tanımlıyorsanız aşağıdaki adımları tamamlayarak projenizi oluşturmaya başlayabilirsiniz:

1. İş ihtiyaçlarınızı belirleyin

• İşletmenizin neden FedEx web kancaları ile entegre olması gerektiğini en iyi tanımlayan seçeneği belirleyin.

1. Seviye ve seviye özelliklerini seçin

• Proje ihtiyaçlarınıza göre projeniz için temel veya gelişmiş bir web kancası seviyesi seçin.
• Seviye seçiminizi daha sonra dilediğiniz zaman düzenleyebilirsiniz.
• Tüm seviyeler aylık abonelik ücretine tabidir.

• Projenizle birlikte yapılandırılmasını istediğiniz özellikleri seçin.
• Özelliklerinizi daha sonra da düzenleyebilirsiniz.

1. Proje ayrıntılarını yapılandırın

• Projenize tanımlanabilir bir isim verin
• Kurulum öncesi kimlik doğrulama aşamasında belirlenen önceden oluşturulmuş hedef URL ve güvenlik belirteci ayrıntılarını girin.

Hesapları seçin

• Projenizle ilişkilendirilmesini istediğiniz uygun hesap numaralarını (ABD veya Kanada merkezli) listeden seçin.

  5. Bilgileri onaylayın ve koşulları kabul edin

• Yapılandırılmış proje bilgilerinizi gözden geçirin.
• Developer Portal Lisans Sözleşmesini okuyup kabul edin ve uygulamanızı dağıtmayı amaçlamadığınızı teyit edin.
• Fiyatlandırma Anlaşmasını okuyup kabul edin.
• Proje Oluştur düğmesine tıkladığınızda:

1. Oluşturma talebiniz başarıyla doğrulandıysa ve işleme alındıysa bir onay ekranına yönlendirilirsiniz.

• Doğrulama başarısız olursa veya hata ile sonuçlanırsa bir hata mesajı alırsınız.

1. Takip web kancası projeniz daha sonra sistem tarafından oluşturulan bir web kancası kimliğine sahip olur ve "Etkin" duruma sahip olarak gösterilir.

1. FedEx, Uyumlu sağlayıcı kuruluşu oluşturuyor.
2. Daveti kabul edin.
3. Kuruluşunuza kullanıcı davet edin.
4. Çözümünüz için ihtiyaç duyduğunuz API'leri seçin.
5. FedEx projeler oluşturuyor.
6. Uygulamanıza API'leri entegre edin ve Uyumlu Program için sertifika alın.
7. FedEx projeleri üretime geçiriyor.
8. Üretim Gizli Anahtarı oluşturun.

• FedEx bir kuruluş oluşturacak ve ardından bir ekip üyesini kuruluşa katılmaya davet edecek. Bu kullanıcı, kuruluşunuz için yönetici olarak belirlenecek.
• Sertifikasyon ve entegrasyonun tamamlanmasının ardından, çözümü müşterilerinize kolayca dağıtabileceksiniz.

• API entegrasyon yapılarına erişim elde etmek için lütfen daveti kabul edin. Daveti kabul etmek için FedEx Kullanıcı Kimliğiniz ve parolanızla oturum açmanız veya halihazırda kullanıcı bilgileriniz yoksa bu bilgileri oluşturmanız gerekir.

• Yönetici olarak, projeye veya kuruluşa erişmesi gereken tüm ekip üyelerini davet edebilirsiniz. Farklı görevler hakkında daha fazla bilgi için Kuruluş Yönetim Kılavuzu'nu inceleyin.

• Kuruluşunuz zaten oluşturulduysa, kuruluş veya FedEx yöneticisinden sizi katılmaya davet etmesini isteyin. Daveti 24 saat içinde kabul etmeniz gerekecektir ancak bu süreyi kaçırırsanız davetin yeniden gönderilmesini isteyebilirsiniz.

• Çözümünüze yönelik doğru API'lerini belirlemek için API Kataloğu'nu ziyaret edin. FedEx Müşteri Teknolojisi Danışmanınız (Customer Technology Consultant - CTC) ve Uyumlu Kanal yöneticiniz, iş ihtiyaçlarınıza uygun olarak çözümünüz için doğru API'leri seçmenize yardımcı olabilir.

• Genel görünümünü, değişim günlüklerini ve önemli özelliklerini keşfetmek için bir API seçin.

• Talep ve yanıt öğelerini, tercih ettiğiniz dildeki örnekleri, hata nesnelerini ve daha fazlasını görmek için API belgelerini inceleyin.

• Ürün Bilgisi Çalışma Sayfası'nı (Product Information Worksheet - PIW) doldurmak ve çözümünüze eklenmesini istediğiniz API'leri listelemek için Satış Gücü'ne geri dönün.

PIW onaylandıktan sonra FedEx projelerinizi oluşturacaktır. FedEx Developer Portal üzerinde çözümlerinizin her bir sürümü için ayrı bir proje olacaktır. Kuruluşun Yöneticisi olmayan kullanıcıların projeleri görüntüleyebilmesi için davet edilmesi gerekir. 

FedEx Uyumluluk ekibi ile FedEx CTC ve sertifikasyon ekiplerinin, ekibiniz için teknik bir gösterim düzenleyecek olması halinde de bu durum geçerlidir. FedEx ekibi, kullanmaya başladığınız API'lerin sürümüyle kullanılabilir yeni özellik ve işlevleri anlatacaktır. Ekip, API'lere, API testlerine ve API'ler için "sertifikasyon*" sürecini başlatmak için tamamlanması gereken tüm süreçlere ilişkin teknik soruları yanıtlayabilecek donanıma sahip olacaktır.

* Sertifikasyon – FedEx Uyumlu Program tarafından Program Uyumluluk gereksinimlerini karşılamak için tanımlanan süreç. Tüm Uyumlu Sağlayıcıların, FedEx teknolojisini göndericilere (müşterilere) FedEx teknoloji ve hizmet standartlarıyla belirlendiği biçimde uyguladığından, pazarladığından ve dağıttığından emin olmak için Uyumlu Program Sertifikasyonu gereklidir.

1. Artık işlemlerinizi gerçekleştirmeye başlamak için Test API Anahtarı ve Test Gizli Anahtarına erişebileceksiniz. Bu anahtarları, Project Overview (Proje Genel Görünümü) sayfasında bulunan Test Key (Test Anahtarı) sekmesinden alabilirsiniz.

1. Müşteri anahtarları oluşturmak için her projenizin yalnızca API bölümünde bulunan ve özel bir API olan Kullanıcı Bilgileri Kayıt API'sini kullanmanız gerekir.
2. Birkaç müşteri anahtarı oluşturduktan sonra tüm API işlemlerinde kullanılacak bir OAuth erişim belirteci isteyin. Belirteç oturumu sadece bir saatliğine geçerlidir. Bu nedenle oturum sona ermeden önce belirteci yenilemek için uygulamanızı programlayarak kodlamanız gerekir. Daha fazla bilgi için API Kimlik Doğrulaması belgelerine bakın. Örnek kodları görüntülerken örnekler açılır listesinden "Reseller" (Satıcı) öğesinin seçildiğinden emin olun.

1. Test Anahtarı sayfanızda API belgelerini seçin ve seçilen API'nin nasıl kullanılacağını en iyi şekilde anlamak için iş bağlamını okuyun. İstediğiniz entegrasyonla eşleşen uç nokta için örnek istekleri gözden geçirin.
2. Çağrılarınızı örnek isteklerde açıklandığı gibi bu uç noktalara uygulayın ve test kimlik bilgilerinizi kullanmak için yapılandırın.
3. Alınan API çağrı yanıtlarının belgelerde gösterilenlerle eşleştiğini doğrulayın.
4. Test kimlik bilgilerini ve FedEx test URI'lerini kullanarak FedEx test ortamındaki uygulamanızı baştan sona test edin.
5. Çözümlerinizi başarıyla test ettikten sonra her bir çözüm için Satış Gücü'nde sertifika alın. FedEx, gönderilen her şeyi eksiksiz bir biçimde gözden geçirecek ve sertifikasyonunuz onaylandığında size bilgi verecektir.

• Ardından FedEx, projelerinizi üretime geçirecektir.
• Bu işlemden sonra, Üretim API Anahtarınızı, Product Overview (Ürün Genel Görünümü) sayfasındaki Production (Üretim) Anahtarı sekmesinde görebilirsiniz.

• Üretim Gizli Anahtarınızın, Gizli Anahtar sütununun altında bulunan Gizli Anahtar Oluştur bağlantısına tıklanarak oluşturulması gerekir.
• Artık örnek verileri kullanarak üretim ortamında uygulamanızı yeniden test edebilirsiniz.
• Yeni entegrasyonunuzun avantajlarından yararlanın!