REST API Laravelのサブスクリプションとトランザクション（支払い）エンドポイント

Question

私はWebアプリケーションを開発しており、REST API標準を守っています。定期購入と支払いのREST APIのベストプラクティスを探しています。

新しいユーザーが「プロ計画」を購読すると、ユーザーは計画のためにお金を払う必要があり、それはトランザクションです。

新しいユーザーが購読すると、POST：users/{id}/subscriptionsとSubscriptionsController@storeを設定する必要がありますか？

サブスクリプションはトランザクションと2つの分離されたリクエスト（前後のバンク）であるため、サブスクライブコードはすべてSubscriptionController@storeである必要がありますか？

PUT：users/{id}/subscriptions/{id}とSubscriptionController@updateまたは他のエンドポイントを設定する必要がありますか、アップグレードをキャンセルまたは更新するには？

Answer 1

通常、コントローラに何らかの認証がない限り、ルートにはユーザIDを渡しません。例えば。管理者がユーザーを更新しています。代わりにコントローラのAuth::user()オブジェクトを使用してください。

あなたの質問に関して、多くのオプションがあり、それはあなた次第ですが、可能な方法はresource route\controllerです。

Route::resource('user/subscription', 'User\SubscriptionController');

そして、コントローラは次のようになります。

<?php 

namespace App\Http\Controllers\User; 

use Illuminate\Http\Request; 
use Illuminate\Support\Facades\Auth; 

class SubscriptionController extends Controller 
{ 

    public function index() 
    { 
     // get user 
     $user = Auth::user(); 

     // list all user subscriptions 
    } 

    public function store(Request $request) 
    { 

     // get user 
     $user = Auth::user(); 

     if(empty($user)) { 
      // create user 
     } 

     // create and process subscription for the user 
     // possibly using a plan id in the $request 
    } 

    public function show($id) 
    { 
     // get user 
     $user = Auth::user(); 

     // return user subscription details for $id 
    } 

    public function update(Request $request, $id) 
    { 
     // get user 
     $user = Auth::user(); 

     // update or change user subscription 
     // possibly using a plan id in the $request 

    } 


    public function destroy($id) 
    { 
     // get user 
     $user = Auth::user(); 

     // cancel user subscription with $id 
    } 
} 

をそして、あなたのルートは、次のようになります：

GETuser/subscriptionリストのすべてのユーザーサブスクリプションindex()

POSTuser/subscriptionユーザーを作成するサブスクリプションstore(Request $request)

GETuser/subscription/{subscription_id}は、ユーザのサブスクリプションshow($id)

PUT/PATCHuser/subscription/{subscription_id}更新ユーザーサブスクリプションupdate($id)

DELETEuser/subscription/{subscription_id}がブレインツリーやストライプのためのあなたの試みの両方のお支払い場合は、ユーザのサブスクリプションdestroy($id)

Answer 2

私はあなたに求めていることを理解しようとしていますが、私にとってはちょっとぼやけています。そうすれば、APIエンドポイントのネーミングのベストプラクティスを理解しようとしています。提供し、ドキュメンテーションをどのように公開するのかを説明します。

しかし、私の視点から、私はURLでチェーンのユーザーIDと加入者IDに理由が表示されていないが、私はこのようなものをお勧めしますし、あなたが身体

$router->post('settings/user/plan', 'Settings\SubscriptionController@subscribe'); 
$router->put('settings/user/plan', 'Settings\SubscriptionController@changeSubscriptionPlan'); 
$router->delete('settings/user/plan', 'Settings\SubscriptionController@cancelSubscription'); 
$router->post('settings/user/plan/resume', 'Settings\SubscriptionController@resumeSubscription'); 
$router->put('settings/user/card', 'Settings\SubscriptionController@updateCard'); 
$router->put('settings/user/vat', 'Settings\SubscriptionController@updateExtraBillingInfo'); 
$router->get('settings/user/plan/invoice/{id}', 'Settings\SubscriptionController@downloadInvoice'); 

に必要なすべての情報を渡すことができますエンドポイントをどのように定義するかはあなた次第です

Answer 3

をキャンセル示し、ゲートウェイth簡単にメインタン計画とサブスクリプション。

メインBenifits： -

1. サブスクリプションの少ないコーディングとブレインツリードロップUIで準備
2. UIを計画
そのreponsiveが簡単にアドオン料金 可能