missionx-co/laravel-prevent-duplicate-request

A Laravel package that prevents duplicate API requests using Idempotency keys or dynamically generated keys based on request URL and input.

0.1.2 2025-02-05 20:43 UTC

Requires

• php: ^8.3
• illuminate/contracts: ^10.0||^11.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1||^7.10.0
• orchestra/testbench: ^9.0.0||^8.22.0
• spatie/invade: ^2.1

MIT

• Mohammed Manssour

• laravel
• MissionX
• laravel-prevent-duplicate-request

README

A Laravel package to prevent duplicate API requests using either Idempotency Keys or dynamically generated keys based on the request URL and input.

Installation

Install the package via Composer:

composer require missionx-co/laravel-prevent-duplicate-request

Publish the configuration file

php artisan vendor:publish --tag="prevent-duplicate-request-config"

Usage

Middleware Setup

Add the preventDuplicateRequests middleware to your API middleware group

Laravel 11

// bootstrap/app.php
->withMiddleware(function (Middleware $middleware) {
    $middleware->api(append: [
        'preventDuplicateRequests'
    ]);
})

Laravel 10

// app/Http/Kernel.php
protected $middlewareGroups = [
    'web' => [
        // ...
    ],

    'api' => [
        // ...
        'preventDuplicateRequests',
    ],
];

Key Generation Algorithms

To prevent duplicate API requests, you can choose between two algorithms:

1. Idempotency Key: Use \MissionX\LaravelPreventDuplicateRequest\UniqueKeyAlgorithms\IdempotencyKey::class to uniquely identify and deduplicate requests, ensuring the same key results in the same response. This requires the client to send an Idempotency-Key header with each request.

2. Request Fingerprint: Use \MissionX\LaravelPreventDuplicateRequest\UniqueKeyAlgorithms\RequestFingerprintGenerator::class to automatically generate a unique key based on the request URL and input. This is useful when you don't want to rely on the client to provide a key.

Configuring the Algorithm

Set the desired key generation algorithm in the configuration file (config/prevent-duplicate-request.php):

return [
    'key_algorithm' => \MissionX\LaravelPreventDuplicateRequest\UniqueKeyAlgorithms\RequestFingerprintGenerator::class,
];