PHPackages assoft/aras-kargo-laravel - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. assoft/aras-kargo-laravel ActiveLibrary[API Development](/categories/api) assoft/aras-kargo-laravel ========================= Modern Laravel package for Aras Kargo API integration with advanced caching, logging, and rate limiting features v1.0.0(6mo ago)02MITPHPPHP ^8.1 Since Oct 28Pushed 6mo agoCompare [ Source](https://github.com/assoft/aras-kargo-php-api)[ Packagist](https://packagist.org/packages/assoft/aras-kargo-laravel)[ Docs](https://github.com/assoft/aras-kargo-php-api)[ Patreon](https://www.patreon.com/botbenson)[ RSS](/packages/assoft-aras-kargo-laravel/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (8)Versions (2)Used By (0) Aras Kargo Laravel Package ========================== [](#aras-kargo-laravel-package) [![Latest Stable Version](https://camo.githubusercontent.com/7489fdaf66bda454a6c65a72365e0eddeda2f7a67085a952445d6b7af0e7c3bb/68747470733a2f2f706f7365722e707567782e6f72672f6173736f66742f617261732d6b6172676f2d6c61726176656c2f762f737461626c65)](https://packagist.org/packages/assoft/aras-kargo-laravel)[![Total Downloads](https://camo.githubusercontent.com/eea540edc0fa4f931786aa3b02ad91384750da34c3079bb2c426ee5344c7cdf2/68747470733a2f2f706f7365722e707567782e6f72672f6173736f66742f617261732d6b6172676f2d6c61726176656c2f646f776e6c6f616473)](https://packagist.org/packages/assoft/aras-kargo-laravel)[![License](https://camo.githubusercontent.com/3ca64b7e0983edb20568859469b50e45f319768aa235e522ffac55547fd2e88d/68747470733a2f2f706f7365722e707567782e6f72672f6173736f66742f617261732d6b6172676f2d6c61726176656c2f6c6963656e7365)](https://packagist.org/packages/assoft/aras-kargo-laravel)[![Build Status](https://github.com/assoft/aras-kargo-php-api/workflows/Tests/badge.svg)](https://github.com/assoft/aras-kargo-php-api/actions) Modern Laravel package for Aras Kargo API integration with advanced caching, logging, and rate limiting features. Perfect for Laravel 11/12 applications that need to track cargo shipments and manage logistics data. Özellikler ---------- [](#özellikler) - ✅ Laravel 11/12 desteği - ✅ Modern PHP 8.1+ özellikleri - ✅ Cache entegrasyonu - ✅ Logging sistemi - ✅ Service Provider ve Facade desteği - ✅ Configuration management - ✅ Exception handling - ✅ Type declarations ### Change Log [](#change-log) - See [ChangeLog](https://github.com/ismail0234/aras-kargo-php-api/blob/master/CHANGELOG.md) ### License [](#license) - See [ChangeLog](https://github.com/ismail0234/aras-kargo-php-api/blob/master/LICENSE) Kurulum ------- [](#kurulum) Laravel projenizde composer ile kurulum yapın: ``` composer require assoft/aras-kargo-laravel ``` ### Laravel Auto-Discovery [](#laravel-auto-discovery) Paket Laravel'in auto-discovery özelliğini destekler. Service Provider ve Facade otomatik olarak yüklenir. ### Manuel Kurulum [](#manuel-kurulum) Eğer auto-discovery devre dışıysa, `config/app.php` dosyasına ekleyin: ``` 'providers' => [ // ... Assoft\ArasKargo\Providers\ArasKargoServiceProvider::class, ], 'aliases' => [ // ... 'ArasKargo' => Assoft\ArasKargo\Facades\ArasKargo::class, ], ``` ### Configuration [](#configuration) Configuration dosyasını publish edin: ``` php artisan vendor:publish --provider="Assoft\ArasKargo\Providers\ArasKargoServiceProvider" --tag="aras-kargo-config" ``` `.env` dosyanıza Aras Kargo bilgilerinizi ekleyin: ``` ARAS_KARGO_USERNAME=your_username ARAS_KARGO_PASSWORD=your_password ARAS_KARGO_CUSTOMER_CODE=your_customer_code ARAS_KARGO_CACHE_ENABLED=true ARAS_KARGO_LOGGING_ENABLED=true ``` Kullanım -------- [](#kullanım) ### Facade Kullanımı [](#facade-kullanımı) ``` use Assoft\ArasKargo\Facades\ArasKargo; // Kargo bilgisi sorgulama $cargo = ArasKargo::getCargoInformation('9023745602734'); // Tarih aralığı sorgulama $cargos = ArasKargo::getCargoBetweenDate('01-01-2024', '31-01-2024'); ``` ### Service Container Kullanımı [](#service-container-kullanımı) ``` use Assoft\ArasKargo\Contracts\ArasKargoInterface; class CargoController extends Controller { public function __construct( private ArasKargoInterface $arasKargo ) {} public function track(Request $request) { return $this->arasKargo->getCargoInformation($request->tracking_number); } } ``` ### Rate Limiting Middleware (Opsiyonel) [](#rate-limiting-middleware-opsiyonel) Rate limiting middleware'i kullanarak API isteklerini sınırlayabilirsiniz. **Varsayılan olarak devre dışıdır.** #### 1. Rate Limiting'i Etkinleştirme [](#1-rate-limitingi-etkinleştirme) `.env` dosyasında rate limiting'i etkinleştirin: ``` ARAS_KARGO_RATE_LIMIT_ENABLED=true ARAS_KARGO_RATE_LIMIT_MAX_ATTEMPTS=60 ARAS_KARGO_RATE_LIMIT_DECAY_MINUTES=1 ARAS_KARGO_RATE_LIMIT_KEY_PREFIX=aras_kargo_rate_limit ``` #### 2. Middleware Kullanımı [](#2-middleware-kullanımı) ``` // routes/api.php Route::middleware(['aras-kargo.rate-limit:60,1'])->group(function () { Route::get('/cargo/{trackingNumber}', [CargoController::class, 'track']); }); // Controller'da middleware kullanımı class CargoController extends Controller { public function __construct() { $this->middleware('aras-kargo.rate-limit:30,1'); // 30 istek/dakika } } ``` #### 3. Config Dosyasından Yönetim [](#3-config-dosyasından-yönetim) ``` // config/aras-kargo.php 'rate_limit' => [ 'enabled' => env('ARAS_KARGO_RATE_LIMIT_ENABLED', false), // Default: disabled 'max_attempts' => env('ARAS_KARGO_RATE_LIMIT_MAX_ATTEMPTS', 60), 'decay_minutes' => env('ARAS_KARGO_RATE_LIMIT_DECAY_MINUTES', 1), 'key_prefix' => env('ARAS_KARGO_RATE_LIMIT_KEY_PREFIX', 'aras_kargo_rate_limit'), ], ``` #### 4. Özellikler [](#4-özellikler) - **Opsiyonel**: Varsayılan olarak devre dışı - **Config Tabanlı**: Tüm ayarlar config dosyasından yönetilebilir - **Kullanıcı Bazlı**: Authenticated kullanıcılar için ayrı limitler - **IP Bazlı**: Anonymous kullanıcılar için IP bazlı limitler - **Flexible**: Middleware parametreleri config değerlerini override edebilir ### Fonksiyonlar [](#fonksiyonlar) ``` /** * * @description Bir kargonun durumu hakkında bilgi verir. * @param string Kargo Numarası * */ $aras->getCargoInformation(9023745602734); /** * * @description Belirli bir tarihe göre gönderilen kargoların listesini verir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * */ $aras->getCargoMovementDate(date('d-m-Y')); /** * * @description Teslim tarihine göre teslim edilen kargoların listesini verir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * */ $aras->getCargoDevileryDate(date('d-m-Y')); /** * * @description İrsaliye tarihine göre teslim edilen kargoların listesini verir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * */ $aras->getCargoWaybillDevileryDate(date('d-m-Y')); /** * * @description Henüz teslim edilmemiş, bir nedenle teslimat şubesinde bekleyen kargoların listesini verir. * */ $aras->getCargoUnDevilered(); /** * * @description Belirli bir tarihe göre yönlendirilen kargoların listesini verir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * */ $aras->getCargoRedirectDate(date('d-m-Y')); /** * * @description İrsaliye tarihine göre Gidiş dönüş hizmet verilen Geri Dönüşlü kargo * ürünü ile gönderilen kargoların listesini verir * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * */ $aras->getCargoWaybillBackRedirectDate(date('d-m-Y')); /** * * @description Göndericiye iade edilen kargoların listesini verir * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * */ $aras->getCargoSenderReturnDate(date('d-m-Y')); /** * * @description Kargo hareket bilgisini verir * @param int Kargo Numarası * */ $aras->getCargoMovementInformation(9023745602734); /** * * @description Aras Kargoya Ait tüm şube ve şube adres bilgilerini verir. * */ $aras->getAllBranchs(); /** * * @description İki Tarih aralığına göre (İrsaliye Tarihi), kargoların listesini verir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * @param string veya int * */ $aras->getCargoWaybillBetweenDate(date('d-m-Y', time() - 86400 * 30) , date('d-m-Y')); /** * * @description İki tarih aralığına göre (İrsaliya Tarihi), kargo listesini verir. * getCargoWaybillBetweenDate'den farklı olarak tahsilatlı kargo bilgilerini de içerir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * @param string veya int * */ $aras->getCargoWaybillExtraBetweenDate(date('d-m-Y', time() - 86400 * 30) , date('d-m-Y')); /** * * @description İki Tarih aralığına göre, kargoların devir bilgisini verir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * @param string veya int * */ $aras->getCargoTransferBetweenDate(date('d-m-Y', time() - 86400 * 30) , date('d-m-Y')); /** * * @description İki Tarih aralığına göre, kargoların listesini verir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * @param string veya int * */ $aras->getCargoBetweenDate(date('d-m-Y', time() - 86400 * 30) , date('d-m-Y')); /** * * @description İki Tarih aralığına gore (İrsaliye Tarihi), kargoların bilgisini verir. * @note string olarak (d-m-Y) veya int olarak unix timestamp kullanılabilir. * @param string veya int * @param string veya int * */ $aras->getCargoWaybillInformationBetweenDate(date('d-m-Y', time() - 86400 * 30) , date('d-m-Y')); /** * * @description Kargo Durumuyla ilgili genel bilgi verir. * Eğer kargo geri dönüşlü ise bu dataset dolu gelir ve geri dönüş teslimat bilgilerini içerir. * Eğer kargo Geri Dönüşlü değilse bu dataset dolu gelir ve kargo teslimat bilgilerini içerir. * Kargonun devir bilgilerini içerir. * Kargo Yönlendirme ve İade Hareketleri ve Nedenlerini içerir * Geri Dönüşlü Kargo Bilgilerini içerir * @param int Kargo Numarası * @return array * */ $aras->getCargoRealInformation(9093773579276); /** * * @description Fatura Bilgilerini Döner * Normal Fatura ve E-Fatura araması yapılabilir. * Fatura No ve Fatura Tipi parametre olarak geçilir. * Normal fatura için 'fatura', EFatura için 'efatura' parametresi geçilir. * @param string Fatura Numarası * @param string Fatura Türü (efatura/fatura) * @return array * */ $aras->getCargoInvoice("AAA201400040405", 'fatura'); /** * * @description Aras kargonun bugün teslim edilen kargo sayısını döner * @return array * */ $aras->getCargoCountToday(); /** * * @description Kampanya kodu bilgilerini döner * @return array * */ $aras->getCampaignCode("KAMPANYAKODU"); ``` ### Health Score 32 — LowBetter than 72% of packages Maintenance66 Regular maintenance activity Popularity2 Limited adoption so far Community8 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 88.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 196d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d0d705f0504661515506146fb842ea0f01103de40a4b22834e01631b2bd124c6?d=identicon)[assoft](/maintainers/assoft) --- Top Contributors [![ismail0234](https://avatars.githubusercontent.com/u/20711301?v=4)](https://github.com/ismail0234 "ismail0234 (32 commits)")[![assoft](https://avatars.githubusercontent.com/u/835239?v=4)](https://github.com/assoft "assoft (4 commits)") --- Tags apilaravellaravel-packagetrackingshippinglogisticskargocargoaras ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/assoft-aras-kargo-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/assoft-aras-kargo-laravel/health.svg)](https://phpackages.com/packages/assoft-aras-kargo-laravel) ``` ### Alternatives [roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[andreaselia/laravel-api-to-postman Generate a Postman collection automatically from your Laravel API 1.0k586.2k3](/packages/andreaselia-laravel-api-to-postman)[joisarjignesh/bigbluebutton BigBlueButton Server API Library for Laravel 162145.5k1](/packages/joisarjignesh-bigbluebutton)[anahkiasen/flickering A modern interface for the Flickr API 535.9k1](/packages/anahkiasen-flickering)[wayofdev/laravel-symfony-serializer 📦 Laravel wrapper around Symfony Serializer. 2113.6k](/packages/wayofdev-laravel-symfony-serializer)[mahdimajidzadeh/laravel-unsplash Laravel package for Unsplash Api 1111.4k](/packages/mahdimajidzadeh-laravel-unsplash) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)