Tarifs UPS et FedEx en temps réel dans Laravel : une structure qui tient en production

# .env
FEDEX_CLIENT_ID=
FEDEX_CLIENT_SECRET=
FEDEX_TOKEN_URL=
FEDEX_RATES_URL=

// app/Shipping/UpsRateProvider.php (excerpt)
private function token(): string
{
    if ($token = Cache::get('ups.token')) {
        return $token;
    }

    // Client id and secret travel in a Basic auth header, the body is a form
    $data = Http::withBasicAuth(config('services.ups.client_id'), config('services.ups.client_secret'))
        ->asForm()
        ->timeout(8)
        ->post(config('services.ups.token_url'), ['grant_type' => 'client_credentials'])
        ->throw()
        ->json();

    Cache::put('ups.token', $data['access_token'], max((int) $data['expires_in'] - 60, 60));

    return $data['access_token'];
}

// app/Shipping/RateProvider.php
namespace App\Shipping;

interface RateProvider
{
    /** @return RateQuote[] */
    public function quote(ShipmentRequest $request): array;
}

// app/Shipping/RateQuote.php
namespace App\Shipping;

final readonly class RateQuote
{
    public function __construct(
        public string $carrier,
        public string $service,
        public float $price,
        public string $currency,
        public ?int $transitDays = null,
    ) {}
}

// app/Shipping/FedExRateProvider.php
namespace App\Shipping;

use Illuminate\Http\Client\PendingRequest;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Http;

class FedExRateProvider implements RateProvider
{
    public function quote(ShipmentRequest $request): array
    {
        $response = $this->client()->post(config('services.fedex.rates_url'), $this->payload($request));

        if ($response->status() === 401) {
            // Expired token: clear the cache and retry once
            Cache::forget('fedex.token');
            $response = $this->client()->post(config('services.fedex.rates_url'), $this->payload($request));
        }

        return $this->normalize($response->throw()->json());
    }

    private function client(): PendingRequest
    {
        return Http::withToken($this->token())->timeout(8)->retry(2, 200, throw: false);
    }

    private function token(): string
    {
        if ($token = Cache::get('fedex.token')) {
            return $token;
        }

        $data = Http::asForm()->timeout(8)->post(config('services.fedex.token_url'), [
            'grant_type' => 'client_credentials',
            'client_id' => config('services.fedex.client_id'),
            'client_secret' => config('services.fedex.client_secret'),
        ])->throw()->json();

        // Keep the token a little less than its lifetime
        Cache::put('fedex.token', $data['access_token'], max($data['expires_in'] - 60, 60));

        return $data['access_token'];
    }

    private function payload(ShipmentRequest $request): array
    {
        // Build the body described on the carrier developer portal
        return [];
    }

    private function normalize(array $data): array
    {
        // Map each rate to a RateQuote; skip any rate without a price instead of showing 0
        return [];
    }
}

// app/Shipping/RateService.php
namespace App\Shipping;

use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Cache;
use Throwable;

class RateService
{
    /** @param RateProvider[] $providers */
    public function __construct(private array $providers) {}

    public function quotes(ShipmentRequest $request): Collection
    {
        $hash = md5(json_encode($request));

        return collect($this->providers)
            ->flatMap(function (RateProvider $provider) use ($request, $hash) {
                try {
                    // Short cache: rates can change, check each carrier's terms
                    return Cache::remember('rates:'.$provider::class.':'.$hash, 300, fn () => $provider->quote($request));
                } catch (Throwable $e) {
                    report($e);

                    return [];
                }
            })
            ->sortBy('price')
            ->values();
    }
}

// tests/Feature/RateServiceTest.php
Http::fake([
    'fedex.test/oauth/token' => Http::response(['access_token' => 'tok', 'expires_in' => 3600]),
    'fedex.test/rates' => Http::response(json_decode(file_get_contents(base_path('tests/Fixtures/fedex-rates.json')), true)),
]);