dinas/shipping-sdk-php
Composer 安装命令:
composer require dinas/shipping-sdk-php
包简介
PHP client for Dinas Shipping API
关键字:
README 文档
README
PHP client for Shipping API
For more information, please visit https://github.com/dinasjp.
Installation & Usage
Requirements
PHP 8.1 and later.
Install
composer require dinas/shipping-sdk-php
Your project is free to choose the http client of your choice
Please require packages that will provide http client functionality:
https://packagist.org/providers/psr/http-client-implementation
https://packagist.org/providers/php-http/async-client-implementation
https://packagist.org/providers/psr/http-factory-implementation
As an example:
composer require guzzlehttp/guzzle php-http/guzzle7-adapter http-interop/http-factory-guzzle
Manual Installation
Download the files and include autoload.php:
<?php require_once('/path/to/ShippingSdk/vendor/autoload.php');
Getting Started
Please follow the installation procedure and then run the following:
<?php require_once(__DIR__ . '/vendor/autoload.php'); // Configure Bearer (Token) authorization: bearerAuth $config = Dinas\ShippingSdk\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN'); $apiInstance = new Dinas\ShippingSdk\Api\CarsApi( // If you want use custom http client, pass your client which implements `Psr\Http\Client\ClientInterface`. // This is optional, `Psr18ClientDiscovery` will be used to find http client. For instance `GuzzleHttp\Client` implements that interface new GuzzleHttp\Client(), $config ); $status = 'status_example'; // string | Filter by car status $chassis = 'chassis_example'; // string | Filter by chassis number (multiple values separated by spaces) $search = 'search_example'; // string | Search by partial chassis, make, model $voyage = 'voyage_example'; // string | Filter by voyage $photos = True; // bool | Filter by photos presence $on_yard = True; // bool | Filter by yard presence $sort = 'sort_example'; // string | Sort field. Prefix with - for descending. **default: -id** $per_page = 56; // int | Number of items per page. **default: 100** $page = 56; // int | Page number. **default: 1** try { $result = $apiInstance->getCarPhotos($status, $chassis, $search, $voyage, $photos, $on_yard, $sort, $per_page, $page); print_r($result); } catch (Exception $e) { echo 'Exception when calling CarsApi->getCarPhotos: ', $e->getMessage(), PHP_EOL; }
API Endpoints
All URIs are relative to https://shipping.dinas.jp
| Class | Method | HTTP request | Description |
|---|---|---|---|
| CarDocumentsApi | storeCarDocumentFiles | POST /api/cars/docs/file | Store car document files |
| CarDocumentsApi | storeCarDocumentUrls | POST /api/cars/docs/url | Store car document URLs |
| CarPhotosApi | getCarPhotos | GET /api/cars/photos | Get car photos |
| CarPhotosApi | storeCarPhotoFiles | POST /api/cars/photos/file | Store car photos from files |
| CarPhotosApi | storeCarPhotoUrls | POST /api/cars/photos/url | Store car photos from URLs |
| CarsApi | getCars | GET /api/cars | Get paginated list of cars |
| CarsApi | grantCars | POST /api/cars/grant | Clear withhold status |
| CarsApi | holdCars | POST /api/cars/hold | Hold cars from shipping |
| CarsApi | releaseCars | POST /api/cars/release | Allow us to ship cars |
| CarsApi | setYardEta | POST /api/cars/yard/eta | Set yard ETA for cars |
| CarsApi | syncCars | POST /api/cars | Create or update cars |
| CarsApi | withholdCars | POST /api/cars/withhold | Withhold cars upon arrival |
| VoyagesApi | getBlEd | GET /api/voyages/{voyage}/bl-ed | Download Bill of Lading and Export Declaration for a specific voyage |
| VoyagesApi | getVoyage | GET /api/voyages/{voyage} | Retrieve detailed information about a specific voyage |
| VoyagesApi | getVoyages | GET /api/voyages | Retrieve a paginated list of voyages with optional filtering and sorting |
| WebhooksApi | deleteWebhook | DELETE /api/webhooks/{name} | Delete a webhook |
| WebhooksApi | getWebhook | GET /api/webhooks/{name} | Retrieve a specific webhook by name |
| WebhooksApi | getWebhooks | GET /api/webhooks | Retrieve a list of webhooks |
| WebhooksApi | storeWebhook | POST /api/webhooks | Create a new webhook |
| WebhooksApi | testWebhook | POST /api/webhooks/{name}/test | Send a test payload to the webhook to verify it's working |
| WebhooksApi | toggleWebhook | PATCH /api/webhooks/{name}/toggle | Toggle the active status of a webhook |
| WebhooksApi | updateWebhook | PUT /api/webhooks/{name} | Update an existing webhook |
Models
- ActionResponse
- Album
- AlbumFiles
- AlbumInfo
- AlbumType
- AlbumUrls
- AlbumsPaginated
- CarAlbums
- CarBase
- CarData
- CarDocuments
- CarError
- CarModel
- CarPrices
- CarUpdateResponse
- CarYardEta
- CarsPaginated
- Dealer
- DocumentFile
- DocumentInfo
- DocumentType
- DocumentUrl
- ExportMethod
- ExportType
- FuelType
- GrantCarsRequest
- HoldCarsRequest
- InnerCargo
- PaginationLinks
- PaginationMeta
- PriceTerms
- ReleaseCarsRequest
- SetYardEtaRequest
- ShipDateLimit
- SimpleResource
- StockStatus
- VehicleType
- Voyage
- VoyageInfo
- VoyageStatus
- VoyagesPaginated
- Webhook
- WithholdCarsRequest
- Yard
Authorization
bearerAuth
- Type: Bearer authentication (Token)
Tests
To run the tests, use:
composer install vendor/bin/phpunit
Author
About this package
This PHP package is automatically generated by the OpenAPI Generator project:
- API version:
1.1.0- Generator version:
7.17.0-SNAPSHOT
- Generator version:
- Build package:
org.openapitools.codegen.languages.PhpClientCodegen
dinas/shipping-sdk-php 适用场景与选型建议
dinas/shipping-sdk-php 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 254 次下载、GitHub Stars 达 1, 最近一次更新时间为 2025 年 10 月 30 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「sdk」 「shipping」 「logistics」 「psr-7」 「openapi」 「http-client」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 dinas/shipping-sdk-php 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 dinas/shipping-sdk-php 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 dinas/shipping-sdk-php 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
Miaoxing Logistics Plugin
PHP SDK for the Parcel Monkey UK API
PHP wrapper for DPD Germany SOAP API
Metamel Addresses is a polymorphic Laravel package, for address book management. You can add addresses to any eloquent model with ease.
Unofficial PHP SDK for Poste Delivery Business Rest API services
PHP SDK for SpediamoPro Rest API services
统计信息
- 总下载量: 254
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 1
- 点击次数: 9
- 依赖项目数: 1
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2025-10-30