PHPackages wheesnoza/laravel-ship24 - 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. wheesnoza/laravel-ship24 ActiveLibrary[API Development](/categories/api) wheesnoza/laravel-ship24 ======================== A Ship24 API Rapper for Laravel. v2.1.0(3mo ago)17MITPHPPHP ^8.2 Since Aug 31Pushed 3mo ago1 watchersCompare [ Source](https://github.com/wheesnoza/laravel-ship24)[ Packagist](https://packagist.org/packages/wheesnoza/laravel-ship24)[ Docs](https://github.com/wheesnoza/laravel-ship24)[ RSS](/packages/wheesnoza-laravel-ship24/feed)WikiDiscussions main Synced 2d ago READMEChangelog (8)Dependencies (14)Versions (8)Used By (0) Laravel Ship24 ============== [](#laravel-ship24) [![Latest Version on Packagist](https://camo.githubusercontent.com/71175ca926c8c612d8e1aabcc3e8af2ac42057ca9bcb51d73976c149a0261ff9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f77686565736e6f7a612f6c61726176656c2d7368697032342e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/wheesnoza/laravel-ship24)[![Total Downloads](https://camo.githubusercontent.com/bfbf076ead897f25dcd58d596445a69bbca2f44b6a789f7c1968cd96cbd68870/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f77686565736e6f7a612f6c61726176656c2d7368697032342e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/wheesnoza/laravel-ship24)[![GitHub Issues](https://camo.githubusercontent.com/763740b0adfb3efefe554e8ab11b35f5cbb1fd723e444659c116d97a3037e227/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f77686565736e6f7a612f6c61726176656c2d7368697032342e7376673f7374796c653d666c61742d737175617265)](https://github.com/wheesnoza/laravel-ship24/issues) Laravel Ship24 is a powerful package that integrates the Ship24 API seamlessly into your Laravel application. With this package, you can easily track shipments, create new trackers, and manage your tracking information. Table of Contents ----------------- [](#table-of-contents) - [Features](#features) - [Easy Installation](#easy-installation) - [Tracking API Integration](#tracking-api-integration) - [Extensible Architecture](#extensible-architecture) - [Laravel 11/12 Compatibility](#laravel-1112-compatibility) - [Rate Limit Handling](#rate-limit-handling) - [Compatibility](#compatibility) - [Support Policy](#support-policy) - [Verification Status](#verification-status) - [Known Limitations](#known-limitations) - [Breaking Changes](#breaking-changes) - [Installation](#installation) - [Configuration](#configuration) - [Usage](#usage) - [Rate Limit Handling](#rate-limit-handling-1) - [Configuration](#configuration-1) - [Accessing Rate Limit Information](#accessing-rate-limit-information) - [Behavior](#behavior) - [Testing](#testing) - [Contributing](#contributing) - [License](#license) Features -------- [](#features) ### Easy Installation [](#easy-installation) Install via Composer and publish the configuration file to get started quickly. ### Tracking API Integration [](#tracking-api-integration) Provides simplified access to Ship24 tracking endpoints for creating trackers and retrieving results. ### Extensible Architecture [](#extensible-architecture) Uses a layered structure (Facade/Service/Requests/Data) so you can extend or customize behaviors without touching public APIs. ### Laravel 11/12 Compatibility [](#laravel-1112-compatibility) Maintains compatibility with the latest Laravel versions and modern PHP runtimes. ### Rate Limit Handling [](#rate-limit-handling) Supports automatic backoff, exposes rate limit state, and raises a dedicated exception when rate limits are exceeded. Compatibility ------------- [](#compatibility) - Laravel: 11, 12 - PHP: 8.2+ - Dependencies: `illuminate/contracts`, `spatie/laravel-data` are aligned for Laravel 11/12 support Support Policy -------------- [](#support-policy) - Latest Laravel major version (currently 12) is supported. - Previous major version (11) is supported when compatible with current dependencies. - Compatibility validation status is documented below. Verification Status ------------------- [](#verification-status) - Laravel 12: Verified via package tests (Service/Facade regression, request configuration) - Laravel 11: Supported via dependency constraints; verification ongoing Known Limitations ----------------- [](#known-limitations) - Ship24 API availability impacts runtime behavior; errors are surfaced from the HTTP client. - Compatibility is limited to documented Laravel/PHP versions. Breaking Changes ---------------- [](#breaking-changes) - No breaking changes introduced for Laravel 12 compatibility. - If breaking changes are required in the future, alternatives and migration steps will be documented in the release notes. Installation ------------ [](#installation) You can install the package via Composer: ``` composer require wheesnoza/laravel-ship24 ``` After installing, you may publish the configuration file: ``` php artisan vendor:publish --provider="Wheesnoza\Ship24\Providers\Ship24ServiceProvider" --tag=config ``` Configuration ------------- [](#configuration) The package requires an API token, which you should add to your `.env` file: ``` SHIP24_ACCESS_TOKEN=your-access-token ``` Usage ----- [](#usage) ### Retrieve a Tracker by ID [](#retrieve-a-tracker-by-id) ``` use Wheesnoza\Ship24\Facades\Ship24; $tracker = Ship24::tracker('TRACKER_ID'); ``` ### Retrieve Multiple Trackers [](#retrieve-multiple-trackers) ``` use Wheesnoza\Ship24\Facades\Ship24; $trackers = Ship24::trackers(); ``` ### Create a New Tracker [](#create-a-new-tracker) ``` use Wheesnoza\Ship24\Facades\Ship24; $tracker = Ship24::createTracker('TRACKING_NUMBER'); ``` Rate Limit Handling ------------------- [](#rate-limit-handling-1) Rate Limit Handling provides automatic backoff based on RateLimit headers and exposes the latest rate limit information for monitoring and logging. It also raises a dedicated exception when rate limit exhaustion persists. ### Configuration [](#configuration-1) ``` SHIP24_RATE_LIMIT_ENABLED=true SHIP24_RATE_LIMIT_MAX_ATTEMPTS=3 SHIP24_RATE_LIMIT_BASE_DELAY_SECONDS=2 SHIP24_RATE_LIMIT_MAX_DELAY_SECONDS=60 ``` ### Accessing Rate Limit Information [](#accessing-rate-limit-information) Use the following to retrieve the latest rate limit information captured from the most recent API response. ``` use Wheesnoza\Ship24\Facades\Ship24; $rateLimit = Ship24::rateLimit(); ``` ### Behavior [](#behavior) - If RateLimit headers are missing, the package falls back to the default backoff settings. - If rate limiting persists beyond the maximum attempts, a dedicated exception is raised. Testing ------- [](#testing) To run the tests, execute the following command: ``` composer test ``` Contributing ------------ [](#contributing) Contributions are welcome! If you find a bug or have a feature request, please open an issue on [GitHub](https://github.com/wheesnoza/laravel-ship24/issues). License ------- [](#license) This package is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). ### Health Score 40 — FairBetter than 86% of packages Maintenance80 Actively maintained with recent releases Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 Every ~142 days Total 5 Last Release 105d ago Major Versions 1.0.4 → v2.0.12026-02-15 PHP version history (2 changes)1.0.0PHP ^8.0 v2.0.1PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/102c4baceae80e613fa1ff6be9b22e90dc076f62743176de6f1c8c86028640e8?d=identicon)[wheesnoza](/maintainers/wheesnoza) --- Top Contributors [![wheesnoza](https://avatars.githubusercontent.com/u/45123151?v=4)](https://github.com/wheesnoza "wheesnoza (45 commits)") --- Tags apilaravelpackagetrackingship24 ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/wheesnoza-laravel-ship24/health.svg) ``` [![Health](https://phpackages.com/badges/wheesnoza-laravel-ship24/health.svg)](https://phpackages.com/packages/wheesnoza-laravel-ship24) ``` ### Alternatives [dedoc/scramble Automatic generation of API documentation for Laravel applications. 2.1k11.2M100](/packages/dedoc-scramble)[api-platform/laravel API Platform support for Laravel 58171.5k14](/packages/api-platform-laravel)[lettermint/lettermint-laravel Official Lettermint driver for Laravel 1190.2k1](/packages/lettermint-lettermint-laravel)[tarfin-labs/event-machine Event-driven state machines for Laravel with event sourcing, type-safe context, and full audit trail. 199.4k](/packages/tarfin-labs-event-machine) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)