answear/overseas-bundle

Symfony bundle for Overseas api.

3.0.2 2024-12-17 13:04 UTC

Requires

• php: ^8.2
• ext-json: *
• guzzlehttp/guzzle: ^6.0|^7.0
• psr/log: ^1.1||^2.0||^3.0
• symfony/http-kernel: ^6.4|^7.0
• symfony/property-access: ^6.4|^7.0
• symfony/property-info: ^6.4|^7.0
• symfony/serializer: ^6.4|^7.0
• webmozart/assert: ^1.11

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• matthiasnoback/symfony-config-test: ^5.2
• phpro/grumphp: ^2.8
• phpstan/phpstan: ^1.12
• phpstan/phpstan-webmozart-assert: ^1.2
• phpunit/phpunit: ^10.5
• roave/security-advisories: dev-master
• symfony/phpunit-bridge: 6.4.*|^7.0

MIT

README

Overseas integration for Symfony.
Documentation of the API can be found here: https://api.overseas.hr/apiinfo

Installation

• install with Composer

composer require [e-mail]:answear/overseas-bundle.git

Answear\OverseasBundle\AnswearOverseasBundle::class => ['all' => true],
should be added automatically to your config/bundles.php file by Symfony Flex.

Setup

• provide required config data: environment and apiKey

# config/packages/answear_overseas.yaml
answear_overseas:
    environment: test|prod
    apiKey: yourApiKey
    logger: yourCustomLoggerService #default: null

Logger service must implement Psr\Log\LoggerInterface interface.

Usage

Get ParcelShops

@see https://api.overseas.hr/apiinfo#parcelshops

/** @var \Answear\OverseasBundle\Service\ParcelShopsService $parcelShopService **/
$parcelShopService->get();

will return \Answear\OverseasBundle\Response\DTO\ParcelShop[] array.

Get Places

@see https://api.overseas.hr/apiinfo#places

$zipCode = 12345;
$name = 'name';
$approx = true;

/** @var \Answear\OverseasBundle\Service\PlacesService $placesService **/
$placesService->get($zipCode, $name, $approx);

will return \Answear\OverseasBundle\Response\DTO\Place[] array narrowed down to params. or simply

$placesService->get();

to get all places.

Error handling

• Answear\OverseasBundle\Exception\ServiceUnavailableException for all GuzzleException
• MalformedResponseException for partner other errors
• Answear\OverseasBundle\Exception\BadRequestException if validation failed or for error response

Final notes

Feel free to open pull requests with new features, improvements or bug fixes. The Answear team will be grateful for any comments.