???? ???? ?? URL ??? (? : /API /V1)? ??????. 2. Route/API.php? Route :: Prefix ()? ???? ?? ???? ??. 3. ??? ???? (? : App \ Http \ Controllers \ API \ V1)? ????, ??? ? ???? ??????. 4. Laravel API ???? ???? ?? ? ??? ?? ??? ??????. 5. ????? Middleware? ?? ?? ?? ??? ????? ???? ?????. 6. ?? ??? ????, ???? ????, ?? ??? ????, ??? ???? ???? ??? ??? ???? ???? ????. ??? ??? ???? ?? ???? ???? ???? ?????? ??? ?? ???? ?? ?????.

Laravel API ??? ??? ?? ??? ??? ? ?? ???? ???? ?? ?? ?????. ????? ???? ???? ??? ??? ????.

1. URL ?? ?? ?? ?? (URL? ? ?????)

?? ????? ??? ?? ??? API ??? ??? ??? URL ??? ???.

 /API/V1/???
/API/V2/???

Laravel??? routes/api.php ?? ??? ??????.

 // ??/api.php

// v1 ?? ???
route :: prefix ( 'v1')-> group (function () {
    route :: apiresource ( '???', [v1 \ usercontroller :: class]);
});

// v2 ?? ???
route :: prefix ( 'v2')-> group (function () {
    route :: apiresource ( '???', [v2 \ usercontroller :: class]);
});

??? ??? ???? ?????? ???? ??? ???????.

? : ??? ?? ????? ?? ?? ???? ?????? (? : ??, ????).

2. ????? ???? ???? ??????

?? ??? ???? ????? ?? ???????.

 ?/
HTTP/
    Controllers/
        API/
            V1/
            USERCONTROLLER.PHP
            Transformers/
            V2/
                ├ ─? usercontroller.php
                Transformers/

? ???? ?? ????, ?? ??? ? ??? ??? (API ???? ???? ??)? ????.

?? ??:

 // app \ http \ ???? \ api \ v1 \ usercontroller.php
?? ???? ? \ http \ ???? \ api \ v1;

??? usercontroller? ????? ?????
{
    ?? ?? ?? ()
     {
         userresource :: collection (user :: all ());
     }
}

 // app \ http \ ???? \ api \ v2 \ usercontroller.php
?? ???? ? \ http \ ???? \ api \ v2;

??? usercontroller? ????? ?????
{
    ?? ?? ?? ()
    {
        return userv2resource :: collection (user :: with ( 'profile')-> get ());
    }
}

3. ?? ???? ?? API ???? ??????

Laravel? API ???? ?? ? ???? ??? ??? ????.

 PHP Artisan Make : Resource V1/Userresource
PHP Artisan Make : Resource V2/Userv2Resource

??? ????, ?? ???? ?? ???? ? ??? ?? ??? ?????.

4. ?? ?? : ?? ?? ???

??? ??? ?? ??? ????? (? : Accept: application/vnd.myapp.v2 json ). ?? ??????? ? "???"??? ????? ?????? ? ?????.

? ??? ???? ?? ????? ???? Accept ??? ???? ?? ?? ??? ????? ???? ?????. ???? ?? ?? URL ???? ???? ???? ???? .

5. ??? ??? ???? ???? ????

??? ?? ? ? :

• Deprecated ??? ??????
• ?? ??? ???? ??????
• ?? ??? API ????? ?????
• ?? ?? ? ? ??/????? ??????

???? ?? ?? ??? ?? ??? ? :

 // app/http/middleware/checkapiversion.php
?? ?? ?? ($ ??, $ ??, $ ??)
{
    if ($ version === 'v1') {
        ?? ( 'x-api-deprecated : true');
        ?? ( 'X-API-WARN : V1? 2025-01-01'?? ? ?? ???? ????);
    }

    return $ ?? ($ ??);
}

?? ??? ??????.

 route :: prefix ( 'v1')-> ???? ( 'check.api.version : v1')-> group (function () {
    // ...
});

??

• ? URL ?? ?? ( /api/v1/... ) ??
• prefix('v1')
• ? ?? ? ??? ???? ? ???
• ? ?? ??? ????? ??????
• ? ??? ??? ??? ? ?? ???? ????

????? ??? ??? ? ?? ???? ????. ?? ???? API (?????, Github ?)? ??? ??? ?????.

????? : ?? ??, ??? ?????? ?????? ??? ?? ???? ????.

? ??? Laravel API ??? ???? ?? ?????. ??? ??? PHP ??? ????? ?? ?? ??? ?????!