dinas/shipping-sdk-php 问题修复 & 功能扩展

解决BUG、新增功能、兼容多环境部署,快速响应你的开发需求

邮箱:yvsm@zunyunkeji.com | QQ:316430983 | 微信:yvsm316

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

Authorization

bearerAuth

  • Type: Bearer authentication (Token)

Tests

To run the tests, use:

composer install
vendor/bin/phpunit

Author

info@dinas.jp

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
  • 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 我们能提供哪些服务?
定制开发 / 二次开发

基于 dinas/shipping-sdk-php 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ:316430983 微信:yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

统计信息

  • 总下载量: 254
  • 月度下载量: 0
  • 日度下载量: 0
  • 收藏数: 1
  • 点击次数: 9
  • 依赖项目数: 1
  • 推荐数: 0

GitHub 信息

  • Stars: 1
  • Watchers: 0
  • Forks: 0
  • 开发语言: PHP

其他信息

  • 授权协议: MIT
  • 更新时间: 2025-10-30