Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(Delphi ActiveX) Quickbooks OAuth2 in a Desktop AppDemonstrates how to get a QuickBooks OAuth2 access token from a desktop application or script.
uses Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics, Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB; ... procedure TForm1.Button1Click(Sender: TObject); var oauth2: TChilkatOAuth2; success: Integer; url: WideString; numMsWaited: Integer; sbJson: TChilkatStringBuilder; begin // This example requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. // ------------------------------------------------------------------------------------------------ // IMPORTANT: You first need to define an App in the Quickbooks Developer Dashboard. // See How to Create an App in QuickBooks Developer Dashboard // ------------------------------------------------------------------------------------------------ // This example is for desktop applicatons (it is not for code that runs on a web server). // You'll need to add a line (or a few lines of code) to popup a web browser that navigates to a URL. // This is explained in the comments below. // This is the way to initially obtain the OAuth2 access token. Afterwards it can be // repeatedly refreshed without user interaction, as shown in this example: Refresh Quickbooks OAuth2 Access Token. oauth2 := TChilkatOAuth2.Create(Self); // QuickBooks OAuth2 allows for an "http://localhost:<portNumber>/" callback URL for sandbox testing, // but not for production. // For a desktop app, you must provide a script on your web server to redirect to "http://localhost/<portNumber>" // It can be written in C#, PHP, or whatever desired. It must include the query string in the redirection. // For example, in PHP your script would look like this: // <?php // header( 'Location: http://localhost:3017?' . $_SERVER['QUERY_STRING'] ); // ?> oauth2.AppCallbackUrl := 'https://yourwebserver.com/OAuth2.php'; oauth2.ListenPort := 3017; oauth2.AuthorizationEndpoint := 'https://appcenter.intuit.com/connect/oauth2'; oauth2.TokenEndpoint := 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer'; // Replace these with actual values. oauth2.ClientId := 'QUICKBOOKS-CLIENT-ID'; oauth2.ClientSecret := 'QUICKBOOKS-CLIENT-SECRET'; oauth2.UseBasicAuth := 1; oauth2.CodeChallenge := 0; // Indicate the desired access. Possible scopes that can appear in the list are: // com.intuit.quickbooks.accounting: QuickBooks Online API // com.intuit.quickbooks.payment: QuickBooks Payments API // openid: OpenID Connect processing // profile: user's given and family names // email: user's email address // phone: user's phone number // address: user's physical address oauth2.Scope := 'com.intuit.quickbooks.accounting'; // Begin the OAuth2 three-legged flow. This returns a URL that should be loaded in a browser. url := oauth2.StartAuth(); if (oauth2.LastMethodSuccess <> 1) then begin Memo1.Lines.Add(oauth2.LastErrorText); Exit; end; Memo1.Lines.Add('url = ' + url); // At this point, your application should load the URL in a browser. // For example, // in C#: System.Diagnostics.Process.Start(url); // in Java: Desktop.getDesktop().browse(new URI(url)); // in VBScript: Set wsh=WScript.CreateObject("WScript.Shell") // wsh.Run url // in Xojo: ShowURL(url) (see http://docs.xojo.com/index.php/ShowURL) // in Dataflex: Runprogram Background "c:\Program Files\Internet Explorer\iexplore.exe" sUrl // in dBASE: run(false, 'rundll32 url.dll,FileProtocolHandler "' + lcUrl + '"') // The QuickBooks account owner would interactively accept or deny the authorization request. // Add the code to load the url in a web browser here... // Add the code to load the url in a web browser here... // Add the code to load the url in a web browser here... // Now wait for the authorization. // We'll wait for a max of 60 seconds. numMsWaited := 0; while (numMsWaited < 60000) and (oauth2.AuthFlowState < 3) do begin oauth2.SleepMs(100); numMsWaited := numMsWaited + 100; end; // If there was no response from the browser within 60 seconds, then // the AuthFlowState will be equal to 1 or 2. // 1: Waiting for Redirect. The OAuth2 background thread is waiting to receive the redirect HTTP request from the browser. // 2: Waiting for Final Response. The OAuth2 background thread is waiting for the final access token response. // In that case, cancel the background task started in the call to StartAuth. if (oauth2.AuthFlowState < 3) then begin oauth2.Cancel(); Memo1.Lines.Add('No response from the browser!'); Exit; end; // Check the AuthFlowState to see if authorization was granted, denied, or if some error occurred // The possible AuthFlowState values are: // 3: Completed with Success. The OAuth2 flow has completed, the background thread exited, and the successful JSON response is available in AccessTokenResponse property. // 4: Completed with Access Denied. The OAuth2 flow has completed, the background thread exited, and the error JSON is available in AccessTokenResponse property. // 5: Failed Prior to Completion. The OAuth2 flow failed to complete, the background thread exited, and the error information is available in the FailureInfo property. if (oauth2.AuthFlowState = 5) then begin Memo1.Lines.Add('OAuth2 failed to complete.'); Memo1.Lines.Add(oauth2.FailureInfo); Exit; end; if (oauth2.AuthFlowState = 4) then begin Memo1.Lines.Add('OAuth2 authorization was denied.'); Memo1.Lines.Add(oauth2.AccessTokenResponse); Exit; end; if (oauth2.AuthFlowState <> 3) then begin Memo1.Lines.Add('Unexpected AuthFlowState:' + IntToStr(oauth2.AuthFlowState)); Exit; end; // Save the full JSON access token response to a file. sbJson := TChilkatStringBuilder.Create(Self); sbJson.Append(oauth2.AccessTokenResponse); sbJson.WriteFile('qa_data/tokens/qb-access-token.json','utf-8',0); // The full JSON received looks like this: // { // "expires_in": 3600, // "x_refresh_token_expires_in": 8726400, // "refresh_token": "L011546037639r ... 3vR2DrbOmg0Sdagw", // "access_token": "eyJlbmMiOiJBMTI4Q0 ... oETJEMbeggg", // "token_type": "bearer" // } Memo1.Lines.Add('OAuth2 authorization granted!'); Memo1.Lines.Add('Access Token = ' + oauth2.AccessToken); end; |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.