Bir API projesi oluşturun

Projelerim sayfasını ziyaret edin ve API'ler sekmesini açın. API Projesi Oluştur düğmesine tıklayın.

1. Adım: Projenize dahil etmek istediğiniz API'leri seçin

API kotalarını, işlem oran limitlerini ve API doğrulama ayrıntılarını gözden geçirin.

2. Adım: Proje ayrıntılarını yapılandırın

• 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 kesintilerle ilgili bilgiler hakkında bildirim almak için bildirim tercihlerinizi ayarlayın.

3. Adım: FedEx Developer Portal Lisans Sözleşmesi dahil olmak üzere şartları okuyun ve kabul edin

Şartları kabul edip Oluştur düğmesine tıkladığınızda, bir onay ekranı göreceksiniz. Daha sonra test kimlik bilgilerinizi yeni projenizde görüntüleyebilirsiniz.

Web kancası projesi oluşturun

Hedef uygulamanızda veya platformunuzda geçerli bir (geri dönüş) URL'si oluşturun

Hedef URL'niz, FedEx'ten kimlik doğrulama kodları, mesajlar ve web kancası safi yük bildirimleri almak için kullanılacaktır. Güvenliğin sağlanması için URL'nizin HTTPS kullanması gerekir. 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)

Güvenlik belirteci oluşturma

Bu güvenlik belirteci, kuruluşunuz ve FedEx arasında iletilen bilgileri doğrulamak ve onaylamak için gizli bir anahtar olarak kullanılabilir. Güvenlik belirteciniz şunları içermelidir:

• Minimum 26 ve maksimum 100 karakter uzunluğu
• 1 büyük harf
• 1 küçük harf
• 1 rakam

Örnek: Y1F6OiVUQW2JPSElmRE9U0IY5

URL'nizi ve güvenlik belirtecinizi tanımladıktan sonra, bir web kancası projesi oluşturmak için hazırsınız demektir. Projelerim sayfasını ziyaret edin ve Web Kancaları sekmesini açın. Web Kancası Projesi Oluştur düğmesine tıklayın.

Abonelik türünü seçin

FedEx Göndericileri etkinliklerini hesap numaralarına veya takip numaralarına abone edebilirler.

1. Adım: Faturalama hesabınızı onaylayın ve özellikleri seçin

• Onaylamak için listelenen varsayılan faturalama hesabını inceleyin veya kuruluşunuzdan farklı bir hesap seçin.
• Teslimat kanıtı seçenekleri, tahmini teslimat seçenekleri, etkinlikleri izleme ve etkinlik tabanlı filtreleme gibi özellikleri seçerek projenizi yapılandırın.

2. Adım: Proje bilgilerini girin

• Projenize, kuruluşunuza özel ayırt edilebilir bir ad verin.
• Ön kurulum kimlik doğrulaması sırasında oluşturduğunuz hedef URL'nizi ve güvenlik belirteci ayrıntılarını girin (yukarıdaki adımlara bakın).
• En son web kancası güncellemeleri ve kesintilerle ilgili bilgiler hakkında bildirim almak için bir e-posta adresi ve tercih ettiğiniz dili girin.

3. Adım: Şartları okuyun ve kabul edin

FedEx Developer Portal Lisans Sözleşmesi ve Sipariş Formu dahil olmak üzere şartları kabul edip Oluştur düğmesine tıkladığınızda bir onay ekranı göreceksiniz.

Abonelik türü seçiminize bağlı olarak ek adımlar olabilir. Daha fazla bilgi edinmek için belgelere başvurun.

API projesine genel bakış sayfasında, Test anahtarı sekmesinden test kimlik bilgilerinizi (API anahtarı, gizli anahtar ve gönderim hesapları) alın. 

1. Adım: Bir OAuth erişim belirteci isteyin

Her API işleminde OAuth erişim belirtecinin kullanılması gerekir. 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 ayrıntı için API Yetkilendirme belgelerine bakın.

2. Adım: API belgelerini inceleyin

API'lerinizin her biri için dokümantasyona tıklayarak iş bağlamını okuyun ve API'nin nasıl kullanılacağını anlayın. Dokümantasyon sayfanızın üst kısmındaki düğmeye tıklayarak JSON API koleksiyonunu indirmek için oturum açın. Ayrıca istediğiniz entegrasyonla eşleşen uç nokta için örnek isteklerini de gözden geçirebilirsiniz.

Adım 3: Örnek işlemleri test etmek için korumalı alanı kullanın

Sol navigasyondan istediğiniz uç noktaya tıklayarak o özel korumalı ortama gidin. Kullanım durumunuza uygun örnek istekleri belirleyin, ardından test kimlik bilgilerinizi ve FedEx test URL'lerini kullanarak örnek isteklere göre uç noktaya çağrılarınızı gerçekleştirin. Aldığınız API çağrı yanıtlarının belgelerde gösterilenlerle eşleştiğini doğrulayın. Test deneyimimiz hakkında daha fazla bilgi için Korumalı Alan Sanallaştırma Kılavuzu'nu inceleyebilirsiniz.

Web kancası ile test etme

Test yaparak 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.

Projeye genel bakış sayfanızı ziyaret edin ve Üretim anahtarı sekmesini açın.Gelişmiş Entegre Görünürlük Hesap Numarası Abonelik projelerinin üretim ortamına taşınmasına gerek yoktur.

1. Adım: Projeyi yapılandırın

• İhtiyacınıza göre anahtarınızın adını değiştirin.
• 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.

2. Adım: Proje anahtarlarını alın

Üretim API anahtarınızı kopyalayın ve üretim gizli anahtarınız güvenli bir yere gösterilecektir. Üretim gizli anahtarınızın güvenliğini korumak için sadece bir kez gösteriyoruz. Bunu kaybederseniz yenisini oluşturabilirsiniz.

Proje anahtarlarınızı aldıktan ve İleri düğmesine tıkladıktan sonra, proje detaylarınızı Üretim anahtarı sekmesinde göreceksiniz.

• Projenize daha fazla gönderim hesabı eklemek için, gönderim hesapları tablosunun üstündeki Düzenle düğmesine tıklayın.

Bazı API'ler üretim ortamımızda kullanılmak üzere gönderi etiketi doğrulama gerektirir. API'nizin doğrulama gerektirip gerektirmediğini kontrol edin.

1. Adım: Web için etkin uygulamanızla FedEx API'lerini geliştirme ve test etme

Web özellikli uygulamanızı geliştirmeyi tamamladıktan sonra, test kimlik bilgilerini (test gönderi hesapları, API Anahtarı ve Gizli Anahtar) kullanarak testi tamamlayabilirsiniz. Test API Anahtarınız ve Gizli Anahtarınız Proje Genel Bakış sayfasında gösterilir ve istediğiniz zaman görülebilir.

2. Adım: Projenizi üretime taşıma

FedEx API'leriyle test ettikten sonra, projenizi FedEx Developer Portal'da üretime taşıyarak doğrulama sürecini başlatmanız gerekir. İşlemi başarıyla tamamladıktan sonra üretim API Anahtarınızı ve Gizli Anahtarınızı göreceksiniz. Üretim Gizli Anahtarınızı yalnızca bir kez göreceksiniz, ancak daha sonra yeniden oluşturabileceksiniz.

3. Adım: Etiket Kapak Sayfasını doldurma

Etiket Kapak Sayfasını uygun iletişim bilgileriyle ve uygulayacağınız hizmetlerle eksiksiz doldurun. Hesap numaranızı ve üretim anahtarını ekleyin.

4. Adım: Test etiketlerini oluşturun ve Barkod Analiz Grubu'na gönderin.

Uygulama ile ilişkili FedEx test ortamında, test etiketleri oluşturun ve test etiketlerini FedEx etiket değerlendirme ekiplerinin onayına gönderin. Barkod Analiz grubunda etiket değerlendirmesi için üç iş günü gereklidir.

İşlem gecikmelerini önlemek için aşağıdaki en iyi uygulamaları takip edin:

• Etiketler en düşün 600 DPI ile basılmalı ve taranmalıdır. API'LERİN OLUŞTURULDUĞU DOSYALARI GÖNDERMEYİN.
• Termal yazıcılar için, etiket görüntü türü yazıcı modeliyle uyumlu olarak talep edilmelidir. Örnek: Zebra yazıcılar için ZPLII.
• Değerlendirme için örnek etiketler oluştururken gönderici/alıcı adres bilgilerini kullanın. Sadece uygulanmakta olan belirli hizmetler için örnek etiketler oluşturun.
• FedEx® Teslimatta Nakit Ödeme (C.O.D.) etiketi, ilgili Teslimatta Nakit Ödeme bilgilerini de içermelidir. İade etiketi.
• FedEx International Express® gönderileri aynı zamanda yardımcı/ikincil Havayolu Konşimentosu (AWB) etiketini içermelidir.
• Çok parçalı gönderilerde (MPS), gönderideki her paket için bir etiket bulunmalıdır.
• PDF ve Etiket Kapak sayfasını şu adrese e-posta ile gönderin: label@fedex.com
• Fiziksel etiketler aşağıdaki adrese gönderilebilir:

       FedEx Hizmetleri

       WTC-Business Solutions Testing

       10 FedEx Parkway

       2nd Floor Horizontal

       Collierville, TN 38017

Taranan etiketler görünür kusurlar olmadan (barkoddan geçen çizgiler, mürekkepte lekeler veya fiziksel hasar) incelemeden geçebilir ve onay verilir.


Fiziksel etiketleri gönderirken etiketlerin baskı kalitesine ve yanlışlıkla büyümemesine/büzüşmemesine (ölçeklem) dikkat edin . Bunlar, etiketlerin etiket değerlendirme sürecini geçmemesinin başlıca iki nedenidir.

5. Adım: Etiket değerlendirmesini inceleyin

Barkod Analiz grubu gönderilen test etiketlerini değerlendirir ve etiketleri onaylar veya reddeder. Barkod Analiz grubu gönderilen etiketlerin onaylanması veya reddedilmesiyle ilgili sizinle iletişime geçer. Etiketler onaylanırsa sonraki adıma devam edin. Etiketler reddedilirse etiketleri istenildiği şekilde düzeltin ve tekrar onaya gönderin.

6. Adım: Uygulamayı etkinleştirin

Test etiketleri, Barkod Analiz Grubu tarafından üretim durumu için onaylandıktan sonra, üretim kimlik bilgilerinizin belirlenen gönderi etiketi işleminin iletilmesi için doğrular ve başarılı doğrulama e-postası ile sizi bilgilendirir. Onayınız proje bazındadır.

7. Adım: URL ve kimlik bilgilerini değiştirme

Üretim URL'si ve üretim bilgileriyle test URL'sini ve test kimlik bilgilerini değiştirme. Örnek verileri kullanarak üretim ortamında uygulamanızı tekrar test edin.