Yeni ShipTime API Client ile PHP Gönderim Entegrasyonlarınızı Güçlendirin

Son güncelleme: 17 Şubat 2026 08:45

E-ticaret siteleri ve iş uygulamaları geliştiren yazılımcılar için nakliye, önemli bir sorun teşkil etmektedir. Birden fazla taşıyıcı API’si ile başa çıkmak, tarifeleri hesaplamak, etiketleri basmak ve gönderimleri takip etmek genellikle karmaşık ve kırılgan entegrasyonlara neden olur. Peki, her şeyi tek bir sistem üzerinden yönetebilseydiniz?

<p><strong>ShipTime</strong> ile tanışın; işletmeler için lojistik süreçlerini basitleştiren hepsi bir arada nakliye hizmeti. ShipTime, büyük taşıyıcılardan tarifeleri karşılaştırmanıza, etiketler basmanıza ve tüm gönderimlerinizi tek bir yerde yönetmenize olanak tanır, çoğu zaman indirimli fiyatlarla [1].</p>

<p>PHP geliştiricileri için entegrasyonu daha da kolaylaştırmak amacıyla, ShipTime REST API'si için yepyeni ve modern bir PHP istemci kütüphanesini tanıtmaktan mutluluk duyuyorum: <strong><code>tigusigalpa/shiptime-php</code></strong> [2].</p>

<p>Bu kütüphane, PHP 8.1+ için sıfırdan inşa edilmiştir ve Laravel ile sorunsuz entegrasyon sunarak uygulamalarınıza güçlü nakliye yetenekleri eklemenizi sağlar.</p>

<h2>
    <a name="why-a-new-client-library" href="#why-a-new-client-library"></a>
    Neden Yeni Bir İstemci Kütüphanesi?
</h2>

<p>ShipTime güçlü bir REST API sunmasına rağmen [3], doğrudan entegrasyonu hâlâ HTTP isteklerini, kimlik doğrulamayı ve veri haritalamayı yönetmek için birçok boilerplate kod gerektirebilir. Bu kütüphane bu karmaşıklığı soyutlayarak, herhangi bir modern PHP projesinde yerinde hissettiren temiz, nesne yönelimli bir arayüz sağlar.</p>

<h3>
    <a name="key-features" href="#key-features"></a>
    Ana Özellikler
</h3>

<ul>
    <li>🚀 <strong>Modern PHP 8.1+</strong>: En son dil özellikleri olan enums, readonly özellikler ve katı tip kontrolü gibi özelliklerden faydalanarak daha güvenilir ve sürdürülebilir kod sağlar.</li>
    <li>🔧 <strong>Tam Laravel Entegrasyonu</strong>: Laravel uygulamalarınıza zahmetsiz entegrasyon için bir hizmet sağlayıcı ve facade içerir. Yapılandırma kolaydır; sadece API anahtarlarınızı <code>.env</code> dosyanıza ekleyin.</li>
    <li>📦 <strong>Tam API Kapsamı</strong>: Rates, Shipments, Tracking, Orders ve Pickups dahil olmak üzere tüm önemli ShipTime API özelliklerine erişim sağlar.</li>
    <li>🎨 <strong>Temiz Mimari</strong>: Hizmet odaklı bir mimari ve kapsamlı Veri Transfer Nesneleri (DTO'lar) ile tasarlanmıştır, bu da geliştirici deneyiminizi temiz, tip güvenli ve sezgisel hale getirir.</li>
    <li>🛡️ <strong>Sağlam Hata Yönetimi</strong>: Farklı API hataları için belirli istisna türleri ile birlikte gelir, bu da hata ayıklamayı ve hata yönetimini anlaşılır kılar.</li>
</ul>

<h2>
    <a name="getting-started" href="#getting-started"></a>
    Başlarken
</h2>

<p>Kütüphaneyi projeye entegre etmek oldukça basit. İlk olarak, Composer aracılığıyla kurulum gerçekleştirin:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>composer require tigusigalpa/shiptime-php

<h3>
    <a name="for-laravel-users" href="#for-laravel-users"></a>
    Laravel Kullanıcıları İçin
</h3>

<p>Eğer Laravel kullanıyorsanız, hizmet sağlayıcı otomatik olarak kaydedilecektir. Tek yapmanız gereken yapılandırma dosyasını yayınlamak ve kimlik bilgilerinizi eklemektir:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan vendor:publish --tag=shiptime-config

<p>Sonrasında, ShipTime API anahtarınızı ve gizlinizi <code>.env</code> dosyanıza ekleyin:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code>SHIPTIME_API_KEY=your_api_key

SHIPTIME_API_SECRET=your_api_secret

<p>Artık <code>ShipTime</code> istemcisini doğrudan kontrolörlerinize enjekte edebilir veya <code>ShipTime</code> facade'ını kullanabilirsiniz:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\ShipTime\Facades\ShipTime;

// Bir paketin nakliye tarifelerini al
$rates = ShipTime::rates()->getRates($rateRequest);

<h3>
    <a name="standalone-php" href="#standalone-php"></a>
    Bağımsız PHP
</h3>

<p>Laravel kullanmıyor musunuz? Sorun değil. İstemciyi doğrudan herhangi bir PHP projesinde kullanabilirsiniz:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\ShipTime\ShipTime;

$shiptime = new ShipTime([
‘apiKey’ => ‘your_api_key’,
‘apiSecret’ => ‘your_api_secret’
]);

// Bir gönderi oluştur
$shipment = $shiptime->shipments()->createShipment($shipRequest);

<h2>
    <a name="example-fetching-shipping-rates" href="#example-fetching-shipping-rates"></a>
    Örnek: Nakliye Tarifelerini Alma
</h2>

<p>Şimdi, hangi nakliye tarifelerine sahip olduğunuzu görmek için kütüphanenin nasıl kullanılacağını görelim. Kütüphane, API'ye gönderilen tüm verilerin doğru yapılandırıldığını ve doğrulandığını sağlamak için DTO'lar kullanır.<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\ShipTime\DTOs\RateRequest;

use Tigusigalpa\ShipTime\DTOs\Address;
use Tigusigalpa\ShipTime\DTOs\LineItem;
use Tigusigalpa\ShipTime\Enums\PackageType;
use Tigusigalpa\ShipTime\Enums\UnitOfMeasurement;

$from = new Address(/ … /);
$to = new Address(/ … /);
$lineItem = new LineItem(length: 12.0, width: 8.0, height: 6.0, weight: 5.5);

$rateRequest = new RateRequest(
from: $from,
to: $to,
packageType: PackageType::PACKAGE,
lineItems: [$lineItem],
unitOfMeasurement: UnitOfMeasurement::IMPERIAL,
shipDate: ‘2024-02-20’
);

$rateResponse = ShipTime::rates()->getRates($rateRequest);

foreach ($rateResponse->availableRates as $quote) {
echo “Carrier: {$quote->carrierName} – {$quote->totalCharge->amount} {$quote->totalCharge->currency->value}\n”;
}

<p>Tekrar ifade etmek gerekirse, birkaç satır kod ile mevcut nakliye seçeneklerinin ve maliyetlerinin bir listesini alabilir ve bunu kullanıcılarınıza sunabilirsiniz.</p>

<h2>
    <a name="final-thoughts" href="#final-thoughts"></a>
    Son Düşünceler
</h2>

<p><code>shiptime-php</code> kütüphanesi, ShipTime ile entegrasyonun PHP geliştiricileri için hızlı ve keyifli bir deneyim olmasını sağlamak amacıyla tasarlanmıştır. Modern, tip güvenli ve iyi yapılandırılmış bir istemci sunarak, kullanıcılarınız için harika özellikler geliştirmeye odaklanmanızı sağlar.</p>

<p>Bir sonraki projenizde denemek için şans verin! Kütüphane açık kaynaklıdır ve GitHub'da mevcuttur. Katkılar, geri bildirimler ve özellik talepleri her zaman memnuniyetle karşılanır.</p>

<p>İyi gönderimlerin olsun!</p>

<hr/>

<h3>
    <a name="references" href="#references"></a>
    Referanslar
</h3>

<p>[1] <a href="https://shiptime.com/" target="_blank" rel="noopener noreferrer">ShipTime | En Uygun Nakliye Tarifelerini Bulun</a><br/>[2] <a href="https://github.com/tigusigalpa/shiptime-php" target="_blank" rel="noopener noreferrer">GitHub - tigusigalpa/shiptime-php</a><br/>[3] <a href="https://restapi.shiptime.com/" target="_blank" rel="noopener noreferrer">ShipTime API Dokümantasyonu</a></p>

Kaynak: Orijinal Makale

Yeni ShipTime API Client ile PHP Gönderim Entegrasyonlarınızı Güçlendirin

Sanal Medya

Son Eklenenler

Acil: Çinli APT, Hacklenen Ağa Erişimi Sürdürmek İçin Yeni Malware Yaydı

React Native’de Laravel Reverb ve react-native-reverb ile Gerçek Zamanlı Olay Yönetimi

Yeni Batarya ve Yeni Bina: GM’nin Elektrikli Geleceği Nereye Gidiyor?

Havalanda Telefonunuza Ne Oluyor?

GroWell Kapağı İncelemesi: 15 Yıldır İlk Kez Saçım Var!

Aoostar mini-PC’ler: 400 $’ın altında Ryzen gücü sunuyor

Siber güvenlik, yapay zeka ve savunma sanayiinden; finans ve sinema dünyasına uzanan geniş bir yelpaze. Teknomers; teknoloji, strateji ve yazılım dünyasını sade bir dille sizlerle buluşturuyor.

Kurumsal

Kategoriler

Populer