تحديد معدل الطلبات وإصدار API

لماذا نستخدم تحديد معدل الطلبات؟

Throttle المضمّن في Laravel

<?php
Route::middleware("throttle:60,1")->group(function () {
    // 60 requests per 1 minute per user/IP
    Route::apiResource("posts", PostController::class);
});

محددات معدل الطلبات المخصصة

<?php
// In AppServiceProvider::boot():
RateLimiter::for("api", function (Request $request) {
    return Limit::perMinute(60)->by($request->user()?->id ?: $request->ip());
});

// Apply:
Route::middleware("throttle:api")->group(fn() => ...);

تحديد معدل الطلبات متعدد المستويات

<?php
RateLimiter::for("api", function (Request $request) {
    return match($request->user()?->plan) {
        "pro"  => Limit::perMinute(300)->by($request->user()->id),
        "free" => Limit::perMinute(60)->by($request->user()?->id ?: $request->ip()),
        default => Limit::perMinute(30)->by($request->ip()),
    };
});

رؤوس استجابة تحديد معدل الطلبات

استراتيجيات إصدار API

إصدار API باستخدام بادئة URL

<?php
Route::prefix("v1")->group(function () {
    Route::apiResource("users", \App\Http\Controllers\Api\V1\UserController::class);
});

Route::prefix("v2")->group(function () {
    Route::apiResource("users", \App\Http\Controllers\Api\V2\UserController::class);
});

وحدات تحكم خاصة بكل إصدار

إيقاف الإصدارات القديمة

<?php
// Middleware for v1 routes:
$response->headers->set("Deprecation", "version="v1"");
$response->headers->set("Sunset", "2026-01-01");

موارد API وإصداراتها

اختبار حدود معدل الطلبات

<?php
RateLimiter::shouldReceive("tooManyAttempts")->andReturn(false);

الملخص

تحقق سريع