Laravel跳转外部API传递数据失败：如何实现验证与回调？

你当前用redirect()->away()->with()传递参数的方式是错误的——with()是把数据存在Laravel的本地session里，外部域名的API根本访问不到你的应用session，所以拿不到这些参数。外部授权类API几乎都是通过URL查询参数来接收client_id、redirect_uri这类参数的。

1. 正确传递参数到外部API #

把需要的参数直接拼到跳转URL的查询字符串里，用http_build_query()自动处理参数编码，避免格式问题：

public function connect($id)
{
    $data = Api::where('id', $id)->first();

    $authParams = [
        'client_id' => $data->api_key, 
        'redirect_uri' => $data->redirect_uri,
        'response_type' => 'code'
    ];

    // 拼接参数到授权URL
    $authUrl = 'https://api.xxx.com/login/dialog?' . http_build_query($authParams);

    return redirect()->away($authUrl);
}

2. 处理外部API的回调 #

外部API验证用户身份后，会把授权码（code）重定向到你指定的redirect_uri，你需要在Laravel里搭建对应的回调路由和处理逻辑：

第一步：添加回调路由 #

在routes/web.php中注册回调路由：

Route::get('/api/auth/callback', 'ApiController@handleAuthCallback');

第二步：编写回调处理方法 #

在对应的控制器里实现接收授权码、换取访问令牌的逻辑：

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

public function handleAuthCallback(Request $request)
{
    // 获取外部API返回的授权码
    $authorizationCode = $request->query('code');

    // 调用外部API的令牌接口，用授权码换取access token
    $tokenResponse = Http::post('https://api.xxx.com/oauth/token', [
        'client_id' => '你的API_KEY', // 可从数据库或配置文件读取
        'client_secret' => '你的API_SECRET', // 敏感信息用POST传递，不要暴露在URL中
        'code' => $authorizationCode,
        'redirect_uri' => $request->getUri(), // 或使用预先配置好的回调地址
        'grant_type' => 'authorization_code'
    ]);

    // 解析返回的令牌数据
    $tokenData = $tokenResponse->json();

    // 后续业务逻辑：例如把token存入数据库、跳转前端页面等
    // 示例：保存到当前用户的关联记录
    auth()->user()->apiTokens()->create([
        'access_token' => $tokenData['access_token'],
        'refresh_token' => $tokenData['refresh_token'],
        'expires_at' => now()->addSeconds($tokenData['expires_in'])
    ]);

    // 跳转回前端并提示成功
    return redirect('/dashboard')->with('success', 'API授权成功');
}

注意事项 #

• 确保你填写的redirect_uri已经在外部API的后台控制台完成配置，否则API会拒绝回调请求
• client_secret是敏感信息，绝对不能通过URL传递，必须在POST请求的表单参数里发送
• 如果外部API要求参数签名，需按照其文档生成签名并加入参数列表

内容的提问来源于stack exchange，提问作者rjcode