API

ShipsGo API, taşımanın mevcut durumunu vermektedir, bu nedenle geçmiş veriler şimdilik mevcut değildir. Ancak, ShipsGo Analytics 360 ile kullanıcılarımız, ShipsGo veritabanıyla birleştirilen geçmiş verilerine göre karşılaştırmalı performans istatistiklerine ulaşabilirler.

API çağrıları, API entegrasyonu ve API teknik destek için ek ücret uygulanmamaktadır.

Hizmetimiz kredi ile çalışmaktadır. İster konteyner ister konşimento (B/L) numarası ile takip edin, her takip talebi için 1 krediye ihtiyacınız var. Bu 1 kredi, yolculuğun sonuna kadar tüm bildirimleri, canlı harita aramalarını ve API çağrılarını içerir.

API ile bir GET fonksiyonu oluşturmanız ve istek URL'sinin sonuna "&mapPoint=true" eklemeniz yeterlidir. Ardından canlı bir harita üzerinde geminin konumunu gösteren yeni bir pencerenin açıldığını göreceksiniz.

Hayır, takip isteklerini göndermek veya API çağrısı yapmak için herhangi bir sınırlama yoktur. API çağrı limitiniz sadece hesaplarınızdaki kredi tutarı ile sınırlıdır.

ShipsGo hesabınızı oluşturduktan sonra kontrol panelinizin sol kenar çubuğundaki ENTEGRASYON bölümünden API anahtarınıza ulaşabilirsiniz. Bu anahtarı, şirketiniz ile ShipsGo arasında bir iletişim kodu olarak düşünebilirsiniz.

API anahtarı sayesinde müşterileriniz konteyner takip talebi gönderdiğinde ShipsGo sistemi firma adını tanır ve talebi firma hesabına kaydeder. Daha sonra sistemimiz size ve müşterilerinize dilerseniz logonuz ve e-posta adresiniz ile bilgilendirme e-postasını gönderir. Ayrıca, bu anahtar kredi tüketiminizin hesaplanması için de kullanılmaktadır.

Ödeme

ShipsGo 3D Secure sistemi kullanmaktadır.

3D Secure, çevrimiçi işlemi tamamlamadan önce cep telefonu numaranıza ve e-posta adresinize tek seferlik bir şifre göndererek sizi yetkisiz çevrimiçi işlemlere karşı korur.

Bu ek yetkilendirme adımı, işlemi tamamlamanız için gereken şifreye yalnızca kart sahibi olarak sizin sahip olmanızı sağlar.

Sistemimizden yapacağınız ödemelerde Visa, Master Card ve Banka Transfer yöntemlerini kullanabilirsiniz.

AMEX kartları şimdilik sistemimizde geçerli değildir.

Daha fazla yardıma ihtiyacınız olursa Canlı Sohbet veya support@shipsgo.com adresinden bize ulaşabilirsiniz.

Üyelik

Deneme süreniz için herhangi bir süre sınırlaması yoktur. Hesabınızı oluşturduğunuzda takip için 5 ücretsiz deneme krediniz olacak. Bunları tükettiğinizde, konteyner takip hizmetimizi kullanmaya devam etmek için daha fazla kredi satın almanız gerekecektir.

Konteyner Takip

ShipsGo, 100'den fazla armatör için konteyner takip desteği sağlar. Takip desteği verdiğimiz tüm armatörleri aşağıdaki linke tıklayarak bulabilirsiniz.

Takip desteği sağladığımız armatörler 👈

Maalesef, konteyner takibi için yalnızca ana konşimento, rezervasyon numarası veya konteyner numarası kabul edilmektedir.

Ara konşimento numarası, freight forwarderler tarafından müşterileri için düzenlenen denizyolu taşımacılığı belgelerini temsil eder. Yani ara konşimento numarasıyla sorgulama yapıldığında armatörün web sitesinde sefer bilgileri bulunamamaktadır.

Armatörlerin çoğu, ana konşimento numaralarını SCAC + ana konşimento numarası olarak oluşturur. Konşimento numaranız bu formata uymuyorsa, ana konşimento numarası değil, ara konşimento numarası olabilir.

Evet, ShipsGo soğutuculu konteynerleri takip edebilir. Konteyner numarasını bilmeniz sistem için yeterlidir. ShipsGo konteyner numarasına sahip olduğu ve taşıyıcı sefer verilerini verdiği sürece, soğutuculu konteyneri de takip edilebilir.

Evet, bir hesap yarattıktan sonra size 5 takip kredisi verilecektir. Bu kredilerle 5 konşimento, konteyner veya rezervasyon numarası takip edip, sistemimizi deneyebilirsiniz. Ücretsiz kredilerinizi tükettikten sonra, konteyner takip hizmetimizi kullanmaya devam etmek için daha fazla kredi satın almanız gerekecektir.

ShipsGo anasayfasından konteyner sahibi armatörü seçin. Ardından konteyner, rezervasyon veya konşimento numaranızı girin ve gönderiyi takip et butonuna tıklayın. Kolayca hesap oluşturup yüklerinizle ilgili bildirimler almaya başlayabilirsiniz!

Evet. ShipsGo Canlı Harita Özelliği sayesinde yükünüzün konumunu görebilirsiniz. Canlı Harita ile yükleme ve boşaltma limanları, geminin varış tarihi, armatör ve gemi adı bilgilerine ulaşabilirsiniz. Ayrıca Canlı Haritamızı web sitenize entegre edebilirsiniz ve müşterileriniz gönderilerini doğrudan web siteniz üzerinden takip edebilir.

Yük Referansı, her türlü bilgiyi girebileceğiniz referansınızdır ve hangi yükler üzerinde çalıştığınızı anlamanıza yardımcı olur.

Sayıları, harfleri veya her ikisinin kombinasyonlarını kullanmakta özgürsünüz. 200 karakteri geçmediğinizden emin olun.

Yük Referansı aynı zamanda notifikasyon e-postalarınızın başlığıdır.

Bazı örnekler; Track1, Shipment35, ShipsGoTrack1875, 6756799, vb.

First ETA (Tahmini Varış Zamanı), sistemimizin armatör veritabanından ilk aldığı planlanan varış tarihidir. First ETA ile Gerçek Varış Tarihi (Actual Arrival Date) arasındaki sapma, konteynerin erken veya geç geldiği günlerin sayısını verir.

Bunun nedeni bazen armatör takip sisteminin mevcut olmaması veya konteyner numarası/ konşimento numarası bilgilerinin yanlış olabilmesidir. Lütfen kontrol edip tekrar deneyin.

Bir armatör gönderiniz hakkında bilgi vermiyorsa, gönderi takip edilemez. Bu nedenle, konteynerin izlenmesinin mümkün olmadığı durumlarda “Untracked” etiketli notifikasyon e-postaları alırsınız. Bu durumda armamtörünüzle telefon veya e-posta yoluyla iletişime geçmelisiniz.

Evet, konteynerlerinizi konteyner numarası, rezervasyon numarası veya ana konşimento numarası ile takip edebilirsiniz. Konteyner takip hizmetimiz için bir ShipsGo hesabınızın olması gerekir. Buradan hesap oluşturma sayfasına ulaşabilirsiniz. Kontrol Paneli Kılavuzu, yüklerinizi ana konşimento numarası ile nasıl takip edeceğinizi açıklamaktadır.

Bir takip talebi gönderdikten sonra, sizi veya müşterilerinizi yükleriniz hakkında güncel tutmak için ShipsGo'dan seçtiğiniz e-posta adreslerine çeşitli bildirim e-postaları gönderilir.

Bu bildirimler; yolculuk bildirimleri, gecikme bildirimleri, zamanında vardı bildirimleri, boşaltıldı uyarısı ve limandan çıktı onayı'dır.

Bildirim e-posta içerikleri:

  • Yükleme, boşaltma ve aktarma liman isimleri,
  • Armatör ve gemi isimleri,
  • Yükleme, boşaltma ve limandan çıkış tarihleri,
  • Toplam yolculuk süresi,
  • Yüklerinizin gecikme günleri.

​Bu bildirim e-postaları aynı zamanda konteynerlerinizin gerçek zamanlı konumunu görmeniz için sizi Canlı Konumlandırma Haritamıza yönlendiren bir link'de içermektedir.

Evet, Excel'le yükleme veya API Entegrasyon yöntemlerini kullanarak birden fazla container'ı aynı anda takip edebilirsiniz. Bu yöntemleri kullanmak için bir hesap oluşturmanız gerekiyor. Hesap oluşturduktan sonra, 5 ücretsiz krediniz ile API yöntemini kullanmaya başlayabilirsiniz. API hakkındaki tüm ayrıntılara buradan ulaşabilirsiniz. 5 ücretsiz kredinizi kullandıktan sonra hesabınızı yükseltirken Excel'le Yükleme yöntemini deneyebilirsiniz, kullanıcı paneli dökümanlarımız size yardımcı olacaktır.

Fiyatlandırma

Shipsgo sistemi kredilerle çalışmaktadır. Her takip talebi (Shipsgo'ya bir yük yüklemek) 1 kredinizi tüketir. Ardından, yüklenen yükler için sınırsız sorgu hakkınız olur ve kredileriniz azalmaz. Yükünüzü konteyner numarası, ana konşimento numarası (B/L) veya rezervasyon numarası ile takip edebilirsiniz. Konşimentonuz kaç konteyner içerirse içersin, konşimento numarası ile takip ettiğinizde sadece 1 kredi tüketilir. Kredileriniz için herhangi bir son kullanma tarihi yoktur. Kredi başına maliyet, satın aldığınız hacme göre değişir. Satın alma hacminiz arttıkça bonus kredi miktarı da artacağı için kredi başına maliyetiniz düşecektir. 

Fiyat hesaplayıcımızı kullanarak kredi başına maliyetinizi ve toplam maliyetinizi hesaplayabilirsiniz.

Bazı kullanıcılar Konşimento Numarası ile takip talebi attıklarında, kredileri konusunda endişelenmektedirler, çünkü konşimento numarası çoğu zaman bünyesinde birden fazla konteyner barındırır.

İşte kural: 1 takip talebi 1 krediye eşittir.

Bu durumda endişelenmenize gerek yok, konşimentonuz kaç konteyner içerirse içersin, konşimento numarası ile takip ettiğinizde sadece 1 kredi tüketilecektir.

Her bir hava yükünü takip etmek için 2 kredi harcamanız gerekir. Konteyner takibine kıyasla, bir hava yükü takibinin iki kredi gerektirmesinin temel nedeni, hava yüklerinin hızlı hareketi nedeniyle (bazı durumlarda split shipments olarak adlandırdığımız birden fazla taşımayı içeren) çok daha sık güncelleme ve gerçek zamanlı veri işlemeyi içermesidir.

Konteyner Takip

Evet, Excel'le yükleme veya API Entegrasyon yöntemlerini kullanarak birden fazla container'ı aynı anda takip edebilirsiniz. Bu yöntemleri kullanmak için bir hesap oluşturmanız gerekiyor. Hesap oluşturduktan sonra, 5 ücretsiz krediniz ile API yöntemini kullanmaya başlayabilirsiniz. API hakkındaki tüm ayrıntılara buradan ulaşabilirsiniz. 5 ücretsiz kredinizi kullandıktan sonra hesabınızı yükseltirken Excel'le Yükleme yöntemini deneyebilirsiniz, kullanıcı paneli dökümanlarımız size yardımcı olacaktır.

Bildirim e-posta içerikleri:

  • Yükleme, boşaltma ve aktarma liman isimleri,
  • Armatör ve gemi isimleri,
  • Yükleme, boşaltma ve limandan çıkış tarihleri,
  • Toplam yolculuk süresi,
  • Yüklerinizin gecikme günleri.

​Bu bildirim e-postaları aynı zamanda konteynerlerinizin gerçek zamanlı konumunu görmeniz için sizi Canlı Konumlandırma Haritamıza yönlendiren bir link'de içermektedir.

Bir takip talebi gönderdikten sonra, sizi veya müşterilerinizi yükleriniz hakkında güncel tutmak için Shipsgo'dan seçtiğiniz e-posta adreslerine çeşitli bildirim e-postaları gönderilir. Bu bildirimler; yolculuk bildirimleri, gecikme bildirimleri, zamanında vardı bildirimleri, boşaltıldı uyarısı ve limandan çıktı onayı'dır.

Evet, konteynerlerinizi konteyner numarası, rezervasyon numarası veya ana konşimento numarası ile takip edebilirsiniz. Konteyner takip hizmetimiz için bir Shipsgo hesabınızın olması gerekir. Buradan hesap oluşturma sayfasına ulaşabilirsiniz. Kontrol Paneli Kılavuzu, yüklerinizi ana konşimento numarası ile nasıl takip edeceğinizi açıklamaktadır.

Bunun nedeni bazen armatör takip sisteminin mevcut olmaması veya konteyner numarası/ konşimento numarası bilgilerinin yanlış olabilmesidir. Lütfen kontrol edip tekrar deneyin.

Bir armatör gönderiniz hakkında bilgi vermiyorsa, gönderi takip edilemez. Bu nedenle, konteynerin izlenmesinin mümkün olmadığı durumlarda “Untracked” etiketli notifikasyon e-postaları alırsınız. Bu durumda armamtörünüzle telefon veya e-posta yoluyla iletişime geçmelisiniz.

First ETA (Tahmini Varış Zamanı), sistemimizin armatör veritabanından ilk aldığı planlanan varış tarihidir. First ETA ile Gerçek Varış Tarihi (Actual Arrival Date) arasındaki sapma, konteynerin erken veya geç geldiği günlerin sayısını verir.

Yük Referansı, her türlü bilgiyi girebileceğiniz referansınızdır ve hangi yükler üzerinde çalıştığınızı anlamanıza yardımcı olur.

Sayıları, harfleri veya her ikisinin kombinasyonlarını kullanmakta özgürsünüz. 200 karakteri geçmediğinizden emin olun.

Yük Referansı aynı zamanda notifikasyon e-postalarınızın başlığıdır.

Bazı örnekler; Track1, Shipment35, ShipsgoTrack1875, 6756799, vb.

Evet. Shipsgo Canlı Harita Özelliği sayesinde yükünüzün konumunu görebilirsiniz. Canlı Harita ile yükleme ve boşaltma limanları, geminin varış tarihi, armatör ve gemi adı bilgilerine ulaşabilirsiniz. Ayrıca Canlı Haritamızı web sitenize entegre edebilirsiniz ve müşterileriniz gönderilerini doğrudan web siteniz üzerinden takip edebilir.

Shipsgo anasayfasından konteyner sahibi armatörü seçin. Ardından konteyner, rezervasyon veya konşimento numaranızı girin ve gönderiyi takip et butonuna tıklayın. Kolayca hesap oluşturup yüklerinizle ilgili bildirimler almaya başlayabilirsiniz!

Evet, bir hesap yarattıktan sonra size 5 takip kredisi verilecektir. Bu kredilerle 5 konşimento, konteyner veya rezervasyon numarası takip edip, sistemimizi deneyebilirsiniz. Ücretsiz kredilerinizi tükettikten sonra, konteyner takip hizmetimizi kullanmaya devam etmek için daha fazla kredi satın almanız gerekecektir.

Evet, Shipsgo soğutuculu konteynerleri takip edebilir. Konteyner numarasını bilmeniz sistem için yeterlidir. Shipsgo konteyner numarasına sahip olduğu ve taşıyıcı sefer verilerini verdiği sürece, soğutuculu konteyneri de takip edilebilir.

Armatörlerin çoğu, ana konşimento numaralarını SCAC + ana konşimento numarası olarak oluşturur. Konşimento numaranız bu formata uymuyorsa, ana konşimento numarası değil, ara konşimento numarası olabilir.

Maalesef, konteyner takibi için yalnızca ana konşimento, rezervasyon numarası veya konteyner numarası kabul edilmektedir.

Ara konşimento numarası, freight forwarderler tarafından müşterileri için düzenlenen denizyolu taşımacılığı belgelerini temsil eder. Yani ara konşimento numarasıyla sorgulama yapıldığında armatörün web sitesinde sefer bilgileri bulunamamaktadır.

Shipsgo, 130'den fazla armatör için konteyner takip desteği sağlar. Takip desteği verdiğimiz tüm armatörleri aşağıdaki linke tıklayarak bulabilirsiniz.

Takip desteği sağladığımız armatörler 👈

Üyelik
Ödeme

Sistemimizden yapacağınız ödemelerde Visa, Master Card ve Banka Transfer yöntemlerini kullanabilirsiniz.

AMEX kartları şimdilik sistemimizde geçerli değildir.

Daha fazla yardıma ihtiyacınız olursa Canlı Sohbet veya support@shipsgo.com adresinden bize ulaşabilirsiniz.

Shipsgo 3D Secure sistemi kullanmaktadır. 3D Secure, çevrimiçi işlemi tamamlamadan önce cep telefonu numaranıza ve e-posta adresinize tek seferlik bir şifre göndererek sizi yetkisiz çevrimiçi işlemlere karşı korur.

Bu ek yetkilendirme adımı, işlemi tamamlamanız için gereken şifreye yalnızca kart sahibi olarak sizin sahip olmanızı sağlar.

API

Shipsgo hesabınızı oluşturduktan sonra kontrol panelinizin sol kenar çubuğundaki ENTEGRASYON bölümünden API anahtarınıza ulaşabilirsiniz. Bu anahtarı, şirketiniz ile Shipsgo arasında bir iletişim kodu olarak düşünebilirsiniz. API anahtarı sayesinde müşterileriniz konteyner takip talebi gönderdiğinde Shipsgo sistemi firma adını tanır ve talebi firma hesabına kaydeder. Daha sonra sistemimiz size ve müşterilerinize dilerseniz logonuz ve e-posta adresiniz ile bilgilendirme e-postasını gönderir. Ayrıca, bu anahtar kredi tüketiminizin hesaplanması için de kullanılmaktadır.

Hayır, takip isteklerini göndermek veya API çağrısı yapmak için herhangi bir sınırlama yoktur. API çağrı limitiniz sadece hesaplarınızdaki kredi tutarı ile sınırlıdır.

API ile bir GET fonksiyonu oluşturmanız ve istek URL'sinin sonuna "&mapPoint=true" eklemeniz yeterlidir. Ardından canlı bir harita üzerinde geminin konumunu gösteren yeni bir pencerenin açıldığını göreceksiniz.

API çağrıları, API entegrasyonu ve API teknik destek için ek ücret uygulanmamaktadır.

Hizmetimiz kredi ile çalışmaktadır. İster konteyner ister konşimento (B/L) numarası ile takip edin, her takip talebi için 1 krediye ihtiyacınız var. Bu 1 kredi, yolculuğun sonuna kadar tüm bildirimleri, canlı harita aramalarını ve API çağrılarını içerir.

Shipsgo API, taşımanın mevcut durumunu vermektedir, bu nedenle geçmiş veriler şimdilik mevcut değildir. Ancak, Shipsgo Analytics 360 ile kullanıcılarımız, Shipsgo veritabanıyla birleştirilen geçmiş verilerine göre karşılaştırmalı performans istatistiklerine ulaşabilirler.

API_DOC

Lütfen aşağıdaki adımları uygulayın:

API ile herhangi bir etkileşim için her zaman API ANAHTARI gereklidir. Bir Shipsgo hesabı oluşturduğunuzda, kontrol panelinizde API anahtarına ulaşabilirsiniz.

API dökümanlarımız, yeni bir takip talebi oluşturmanız hakkında daha ayrıntılı bilgi sağlayabilir. Talep başarılı bir şekilde oluşturulduysa ve Shipsgo'ya gönderildiyse, {requestId} istemcilere 200 OK Durum Kodu ile döner ve bu, talebin sunucuya ulaştığı anlamına gelir. POST başarısız olursa, bir hata mesajı döner. Yöntem için hata yanıtlarının listesine buradan ulaşabilirsiniz. İstemci, başarı yanıtı aldıktan sonra {containerNumber} veya {requestId} kullanarak yük sefer verilerini çağırmak için GET yöntemini çalıştırabilir. Her takip talebi için bir defa POST çalıştırmanız yeterlidir. Ancak istemci ihtiyaç duyduğu kadar GET çağrısı yapabilir.

İpucu:

Her talep günde 3 kez güncellendiğinden, her talep için 3 GET çağrısı yeterlidir.

Dikkat:

Shipsgo API'si, bir konteynerin aktif veya en son yolculuğundan elde edilen verileri sunar.

Shipsgo ara konşimento numara takibi desteklememektedir. Sadece ana konşimento numarası kabul edilir.

Her takip için bir defa POST çalıştırmanız yeterlidir.

Sefer verileri günde 3 kez güncellenmektedir. GET fonksiyonunuzu günde 3 defa tetiklenecek şekilde ayarlayabilirsiniz.

Evet, API hizmeti sağlamaktayız. API ile ilgili tüm detayları burada bulabilirsiniz. Teknik destek ve API entegrasyonuyla ilgili daha fazla bilgi için, canlı desteğe yazabilir veya support@shipsgo.com adresinden bize ulaşabilirsiniz.

Shipsgo hesabınızı oluşturduktan sonra kontrol panelinizin sol kenar çubuğundaki ENTEGRASYON bölümünden API anahtarınıza ulaşabilirsiniz. Bu anahtarı, şirketiniz ile Shipsgo arasında bir iletişim kodu olarak düşünebilirsiniz. API anahtarı sayesinde müşterileriniz konteyner takip talebi gönderdiğinde Shipsgo sistemi firma adını tanır ve talebi firma hesabına kaydeder. Daha sonra sistemimiz size ve müşterilerinize dilerseniz logonuz ve e-posta adresiniz ile bilgilendirme e-postasını gönderir. Ayrıca, bu anahtar kredi tüketiminizin hesaplanması için de kullanılmaktadır.

Hayır, takip isteği göndermek veya sefer verilerini almak için herhangi bir sınırlama yoktur. API çağrı limitiniz sadece hesabınızdaki kredi miktarı ile sınırlıdır. Kredileriniz sadece yükünüzü sisteme POST ettiğinzde tüketilecektir. Birden fazla API çağrısı için ödeme yapmazsınız.

Hayır. Shipsgo halka açık bilgileri toplamaktadır, bu sebeple yetkilendirme gerekli değildir. Armatörünüz, Shipsgo'nun desteklediği armatörlerden biriyse ve bir API anahtarınız varsa, yüklerinizi istediğiniz zaman takip edebilirsiniz.

API ile bir GET fonksiyonu oluşturmanız ve istek URL'sinin sonuna "&mapPoint=true" eklemeniz yeterlidir. Ardından canlı bir harita üzerinde geminin konumunu gösteren yeni bir pencerenin açıldığını göreceksiniz.

API entegrasyonu kullandığınızda, sefer bilgilerini XML veya JSON formatında alırsınız. XML veya JSON dosyasında göreceğiniz ilk şeylerden biri "status" dur. Bu "status" yüklerinizin durumunu gösterir.

Statülerin anlamları şu şekildedir:

InProgress (StatusId = 20): Armatör, konteyner hakkında henüz herhangi bir bilgi paylaşmadı.

Booked (StatusId = 30): Armatör, bu taşımayla ilgili sefer bilgilerini paylaştı. Gemi henüz denize açılmadı.

Loaded (StatusId = 35): Konteyner gemiye yüklendi ancak gemi henüz yükleme limanından yola çıkmadı.

Sailing (StatusId = 40): Konteyner yolda.

Arrived (StatusId = 45): Gemi boşaltma limanına ulaştı ancak sevkiyat boşaltılmayı bekliyor.

Discharged (StatusId = 50): Konteyner boşaltma limanında boşaltıldı edildi.

Untracked (StatusId = 60): Konteyneri taşımakla yükümlü armatörün online takip hizmeti olmadığı için konteynerin takibi yapılamadı.

Takip talebiniz bize ulaştıktan sonra sistemimiz, XML formunu doldurmak için armatör web sitesini kontrol eder

1. Sisteminiz verileri armatörün web sitesinden toplamadan önce ararsa, boş bir veri yanıtı alabilirsiniz. Büyük olasılıkla, ikinci arama girişiminde verileri almış olacaksınız.

2. Armatör henüz sefer verilerini sağlamamışsa, XML yanıtı boş olacaktır. Ancak sistemimiz günde 3 kez armatörün web sitesini kontrol eder ve hazır olduğunda verileri alır. Yapmanız gereken, GET çağrınızı günde 3 kez çalışacak şekilde ayarlamaktır, böylece günün sonunda tüm verilere sahip olabilirsiniz. Bu tür verilerin durumu "in progsess" olarak görünür.

3. Ancak bazen takip talepleri sistemimiz tarafından izlenemez. Bu tür yüklere "untracked" denmektedir. Armatörün konteyner takip sistemi mevcut değilse veya konteyner numarası herhangi bir armatörle ilişkilendirilemiyorsa, yük takip edilemez "untracked" olabilir.

XML Tam Veri Örneği

JSON Tam Veri Örneği

Mevcut API'miz her yükü ayrı ayrı sorgulamanıza izin vermektedir.

Shipsgo'dan veri almak için öncelikle API POST fonksiyonunu kullanarak sistemimize veri göndermelisiniz. Gönderdikden sonra, talebiniz başarıyla bize ulaşacaktır. Ardından, sefer verilerini API'nin GET yöntemiyle çekebilirsiniz.

Talebiniz bize başarılı bir şekilde ulaşınca, yanıt olarak bir talep ID'si atanır. Bu ID'ler, her takip talebiniz için benzersizdir ve yükten yüke farklılık gösterir. Bu ID'ler, POST'unuzun bize başarılı bir şekilde ulaştığını anlamına gelir. Bunu, Shipsgo'dan gelen bir onay mesajı olarak düşünebilirsiniz.

Başarılı yanıt ID örneği: 1-534567

Ancak, talep ID (request-id) yerine aşağıdaki yanıtları almanız POST'unuzun başarısız olduğu anlamına gelir ve verileri açıklamalara göre düzeltmeniz ve talebi tekrar göndermeniz gerekir.

Yanıt: "The Field (Code) Value (test1234) is not in a valid format"

Container number must consist of 11 characters: 4 letters followed By 7 Numbers EX. AAAA1234567

Yanıt: "The Field (Code) Value (EGHU9483781) is not valid"

Konteyner numarasının biçimi doğrudur, ancak sayı geçerli değildir. Konteyner numarası oluşturma kuralları nedeniyle EGHU948378-8 olmalıdır.

Yanıt: "The shipping line field is required"

Shipsgo'nun desteklediği armatör listesine göre bir armatör adı girmeniz gerekmektedir.

Yanıt: "The Entered Value (support@gmaıl.com) In Field (Email) Is Not A Valid Email Address"

E-posta adresinizi yanlış yazdığınız anlamına gelir. Lütfen e-posta adresinizi kontrol ediniz.

Yanıt: "No Active Subscription Or It Is Expire"

Kredilerinizin tükendiği anlamına gelir veya farklı bir sebepten dolayı hesabınız aktif değildir.

Lütfen bu durumda Shipsgo ekibi ile iletişime geçin.

POST işlemini başarıyla tamamladıktan sonra kurallara uyarak GET yöntemini çalıştırabilirsiniz. GET'i çalıştırırken bazı hata mesajlarıyla karşılaşabilirsiniz. İşte bazı hata yanıtları ve anlamları:

Hata:"Invalid Authentication Code"

Geçersiz bir API ANAHTARI kullanıyorsunuz veya hesabınızın API bağlantısını kullanması yasak.

Hata: "No Active Subscription Or It Is Expire"

Kredilerinizin bittiği veya farklı bir sebepten dolayı hesabınızın aktif olmadığı anlamına gelir.

Hata: "There Are No Data Related To the Requested Id"

Yanlış konteyner numarası/talep ID'si giriyorsunuz. Veya takip talebini bize POST olarak göndermediğiniz konteyner verilerini almaya çalışıyorsunuz.

API terimleriyle ilgili tüm detayları burada bulabilirsiniz.

Her yük, talep oluşturma zamanından sonra her 8 saatte bir güncellenir, bu nedenle güncelleme zamanı, oluşturma zamanına göre yükten yüke farklılık gösterebilir. Ancak GET fonksiyonunuzu sabah, öğle ve akşam olmak üzere günde 3 sefere ayarlayabilirsiniz. Böylece günün sonunda, tüm gönderileriniz için tüm güncellemelere sahip olabilirsiniz.

Takip talebini Shipsgo'ya gönderdiğinizde, bir talep ID'si oluşur. Talep ID'sini aldıktan sonra çağrı yapabilirsiniz. Çağrı cevaplanacaktır. Ancak, veriler o anda mevcut olmayabilir ve veri kullanılabilirliği armatöre bağlı olduğundan XML dosyası boş olabilir. Veriler armatörün web sitesinde mevcutsa, ortalama yanıt süresi saniye cinsindendir.

Arama çubuğunu devre dışı bırakmak istiyorsanız web siteleriniz için aşağıdaki iframe kodlarını kullanabilirsiniz.

<iframe

src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?tags=hide-search-box"

id="IframeShipsgoLiveMap"

style="height: 550px;width: 100%;"></iframe>

<script>

if (window.addEventListener)

window.addEventListener("message", ShipsgoMessagesListener);

function ShipsgoMessagesListener() {

if (event.data.Action === "LoadNewContainerCode")

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

event.data.Parameters.ContainerCode + '?tags=hide-search-box';

}

var urlParams = new URLSearchParams(window.location.search);

var defaultQuery = urlParams.get('query');

if (defaultQuery === undefined || defaultQuery === null)

defaultQuery = "default-container-code";

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

defaultQuery + '?tags=hide-search-box';

</script>

Önemli Not: Hem arama çubuğunu hem de hareketler penceresini gizlemek istiyorsanız, her iki çözümü de kodunuza uygulamanız yeterlidir.

Web sitelerinizde kullandığınız Live Map'te hareketler penceresini devre dışı bırakmak istiyorsanız aşağıdaki kodları kullanabilirsiniz.

<iframe

src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?movements=hide"

id="IframeShipsgoLiveMap"

style="height: 550px;width: 100%;"></iframe>

<script>

if (window.addEventListener)

window.addEventListener("message", ShipsgoMessagesListener);

function ShipsgoMessagesListener() {

if (event.data.Action === "LoadNewContainerCode")

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

event.data.Parameters.ContainerCode + '?movements=hide';

}

var urlParams = new URLSearchParams(window.location.search);

var defaultQuery = urlParams.get('query');

if (defaultQuery === undefined || defaultQuery === null)

defaultQuery = "default-container-code";

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

defaultQuery + '?movements=hide';

</script>

Önemli Not: Hem arama çubuğunu hem de hareketler penceresini gizlemek istiyorsanız; her iki çözümü de kodunuza uygulamanız yeterlidir.

Web sitelerinizde kullandığınız Live Map çözümünde yer alan hareketler penceresini ve arama çubuğunu devre dışı bırakmak istiyorsanız aşağıdaki kodları kullanabilirsiniz.

<iframe

src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?movements=hide&tags

=hide-search-box" id="IframeShipsgoLiveMap"

style="height: 550px;width: 100%;"></iframe>

<script>

if (window.addEventListener)

window.addEventListener("message", ShipsgoMessagesListener);

function ShipsgoMessagesListener() {

if (event.data.Action === "LoadNewContainerCode")

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

event.data.Parameters.ContainerCode +

'?movements=hide&tags=hide-search-box';

}

var urlParams = new URLSearchParams(window.location.search);

var defaultQuery = urlParams.get('query');

if (defaultQuery === undefined || defaultQuery === null)

defaultQuery = "default-container-code";

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

defaultQuery + '?movements=hide&tags=hide-search-box';

</script>