WinForms C#应用如何捕获Bungie.net API认证回调URI

嘿，我之前做Bungie.net API的WinForms应用时也卡在这里过！用默认浏览器登录后怎么把回调的令牌拿回到应用里，确实是绕不开的一步，给你两个亲测有效的方案：

方案1：本地HTTP服务器监听回调端口 #

这是最省心的方案，核心思路是让你的WinForms app启动一个轻量级的本地HTTP服务，监听指定端口的回调请求，然后把这个本地地址设为Bungie开发者后台的回调URI。

具体步骤： #

1. 先去Bungie开发者控制台，把回调URI设置成类似http://localhost:8080/bungie-callback的格式（端口随便选，只要没被其他程序占用就行）
2. 在你的WinForms登录按钮点击事件里，加入以下代码：

   using System.Net;
   using System.Diagnostics;
   
   private async void btnLogin_Click(object sender, EventArgs e)
   {
       // 启动HTTP监听器
       var listener = new HttpListener();
       listener.Prefixes.Add("http://localhost:8080/bungie-callback/");
       listener.Start();
   
       // 唤起默认浏览器打开Bungie授权页面，记得替换成你的client_id
       var authUrl = "https://www.bungie.net/en/OAuth/Authorize?client_id=YOUR_CLIENT_ID&response_type=code&scope=basic";
       Process.Start(new ProcessStartInfo(authUrl) { UseShellExecute = true });
   
       try
       {
           // 异步等待回调请求
           var context = await listener.GetContextAsync();
           // 从回调URL里提取授权码code
           var authCode = context.Request.QueryString["code"];
   
           // 这里就可以拿着authCode去调用Bungie的token接口换令牌了
           if (!string.IsNullOrEmpty(authCode))
           {
               MessageBox.Show($"拿到授权码：{authCode}\n接下来可以换令牌啦！");
               // 调用你的token交换逻辑...
           }
   
           // 给浏览器返回一个成功提示，避免用户看到空白页
           var response = context.Response;
           var responseString = "<html><body>登录成功！请返回应用。</body></html>";
           var buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
           response.ContentLength64 = buffer.Length;
           var output = response.OutputStream;
           output.Write(buffer, 0, buffer.Length);
           output.Close();
       }
       catch (Exception ex)
       {
           MessageBox.Show($"处理回调出错：{ex.Message}");
       }
       finally
       {
           // 关闭监听器
           listener.Stop();
       }
   }
   

3. 拿到authCode后，就可以调用Bungie的令牌接口，用授权码换取访问令牌和刷新令牌了。

方案2：自定义URI协议唤起应用 #

如果不想开本地服务器，也可以注册一个自定义的URI协议（比如bungieapp://callback），让Bungie登录完成后直接唤起你的WinForms应用，把授权码通过命令行参数传进来。

具体步骤： #

1. 在Bungie开发者控制台把回调URI设置为bungieapp://callback
2. 注册自定义URI协议（需要管理员权限，可以在应用第一次启动时处理）：

   using Microsoft.Win32;
   
   private void RegisterUriProtocol()
   {
       var appPath = Application.ExecutablePath;
       using (var key = Registry.ClassesRoot.CreateSubKey("bungieapp"))
       {
           key.SetValue("", "URL:Bungie App Callback Protocol");
           key.SetValue("URL Protocol", "");
           using (var shellKey = key.CreateSubKey(@"shell\open\command"))
           {
               // 把回调地址作为命令行参数传给应用
               shellKey.SetValue("", $"\"{appPath}\" \"%1\"");
           }
       }
   }
   

3. 在Program.cs里处理命令行参数，提取授权码：

   static void Main(string[] args)
   {
       Application.EnableVisualStyles();
       Application.SetCompatibleTextRenderingDefault(false);
   
       string authCode = null;
       if (args.Length > 0 && args[0].StartsWith("bungieapp://callback"))
       {
           var callbackUri = new Uri(args[0]);
           authCode = System.Web.HttpUtility.ParseQueryString(callbackUri.Query)["code"];
       }
   
       // 把authCode传给主窗体处理
       Application.Run(new MainForm(authCode));
   }
   

4. 主窗体可以在构造函数里接收authCode，然后执行令牌交换逻辑。

注意事项： #

• 两种方案都要保证Bungie后台的回调URI和你应用里设置的完全一致，差一个字符都会失败
• 授权码code的有效期很短，拿到后要立即调用令牌接口
• 用HTTP监听器时，记得处理端口被占用的异常，可以加个端口检测逻辑

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