Sample code for 30+ languages & platforms
C++

Quickbooks OAuth1 Authorization (3-legged)

See more QuickBooks Examples

Demonstrates 3-legged OAuth1 authorization for Quickbooks.

Chilkat C++ Downloads

C++
#include <CkHttp.h>
#include <CkHttpRequest.h>
#include <CkHttpResponse.h>
#include <CkHashtable.h>
#include <CkStringBuilder.h>
#include <CkSocket.h>
#include <CkTask.h>
#include <CkOAuth2.h>
#include <CkJsonObject.h>
#include <CkFileAccess.h>

void ChilkatSample(void)
    {
    bool success = false;

    const char *consumerKey = "QUICKBOOKS_CONSUMER_KEY";
    const char *consumerSecret = "QUICKBOOKS_CONSUMER_SECRET";

    const char *requestTokenUrl = "https://oauth.intuit.com/oauth/v1/get_request_token";
    const char *authorizeUrl = "https://appcenter.intuit.com/Connect/Begin";
    const char *accessTokenUrl = "https://oauth.intuit.com/oauth/v1/get_access_token";

    //  The port number is picked at random. It's some unused port that won't likely conflict with anything else..
    const char *callbackUrl = "http://localhost:3017/";
    int callbackLocalPort = 3017;

    //  The 1st step in 3-legged OAuth1.0a is to send a POST to the request token URL to obtain an OAuth Request Token
    CkHttp http;

    http.put_OAuth1(true);
    http.put_OAuthConsumerKey(consumerKey);
    http.put_OAuthConsumerSecret(consumerSecret);
    http.put_OAuthCallback(callbackUrl);

    CkHttpRequest req;
    req.put_HttpVerb("POST");
    req.put_ContentType("application/x-www-form-urlencoded");

    CkHttpResponse resp;
    success = http.HttpReq(requestTokenUrl,req,resp);
    if (success == false) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

    if (resp.get_StatusCode() >= 400) {
        std::cout << "Error response status code = " << resp.get_StatusCode() << "\r\n";
        std::cout << resp.bodyStr() << "\r\n";
        return;
    }

    //  If successful, the resp.BodyStr contains this:  
    //  oauth_token=-Wa_KwAAAAAAxfEPAAABV8Qar4Q&oauth_token_secret=OfHY4tZBX2HK4f7yIw76WYdvnl99MVGB&oauth_callback_confirmed=true
    std::cout << resp.bodyStr() << "\r\n";

    CkHashtable hashTab1;
    hashTab1.AddQueryParams(resp.bodyStr());

    const char *requestToken = hashTab1.lookupStr("oauth_token");
    const char *requestTokenSecret = hashTab1.lookupStr("oauth_token_secret");
    http.put_OAuthTokenSecret(requestTokenSecret);

    std::cout << "oauth_token = " << requestToken << "\r\n";
    std::cout << "oauth_token_secret = " << requestTokenSecret << "\r\n";

    //  ---------------------------------------------------------------------------
    //  The next step is to form a URL to send to the AuthorizeUrl
    //  This is an HTTP GET that we load into a popup browser.
    CkStringBuilder sbUrlForBrowser;
    sbUrlForBrowser.Append(authorizeUrl);
    sbUrlForBrowser.Append("?oauth_token=");
    sbUrlForBrowser.Append(requestToken);
    const char *url = sbUrlForBrowser.getAsString();

    //  When the urlForBrowser is loaded into a browser, the response from Quickbooks will redirect back to localhost:3017
    //  We'll need to start a socket that is listening on port 3017 for the callback from the browser.
    CkSocket listenSock;

    int backLog = 5;
    success = listenSock.BindAndListen(callbackLocalPort,backLog);
    if (success == false) {
        std::cout << listenSock.lastErrorText() << "\r\n";
        return;
    }

    //  Wait for the browser's connection in a background thread.
    //  (We'll send load the URL into the browser following this..)
    //  Wait a max of 60 seconds before giving up.
    CkSocket sock;
    int maxWaitMs = 60000;
    CkTask *task = listenSock.AcceptNextAsync(maxWaitMs,sock);
    task->Run();

    //  Launch the system's default browser navigated to the URL.
    CkOAuth2 oauth2;
    success = oauth2.LaunchBrowser(url);
    if (success == false) {
        std::cout << oauth2.lastErrorText() << "\r\n";
        return;
    }

    //  Wait for the listenSock's task to complete.
    success = task->Wait(maxWaitMs);
    if (!success || (task->get_StatusInt() != 7) || (task->get_TaskSuccess() != true)) {
        if (!success) {
            //  The task.LastErrorText applies to the Wait method call.
            std::cout << task->lastErrorText() << "\r\n";
        }
        else {
            //  The ResultErrorText applies to the underlying task method call (i.e. the AcceptNextConnection)
            std::cout << task->status() << "\r\n";
            std::cout << task->resultErrorText() << "\r\n";
        }

        delete task;
        return;
    }

    //  If we get to this point, the connection from the browser arrived and was accepted.

    //  We no longer need the listen socket...
    //  Close it so that it's no longer listening on port 3017.
    listenSock.Close(10);

    delete task;

    //  Read the start line of the request..
    const char *startLine = sock.receiveUntilMatch("\r\n");
    if (sock.get_LastMethodSuccess() == false) {
        std::cout << sock.lastErrorText() << "\r\n";
        return;
    }

    //  Read the request header.
    const char *requestHeader = sock.receiveUntilMatch("\r\n\r\n");
    if (sock.get_LastMethodSuccess() == false) {
        std::cout << sock.lastErrorText() << "\r\n";
        return;
    }

    //  The browser SHOULD be sending us a GET request, and therefore there is no body to the request.
    //  Once the request header is received, we have all of it.
    //  We can now send our HTTP response.
    CkStringBuilder sbResponseHtml;
    sbResponseHtml.Append("<html><body><p>Chilkat thanks you!</b></body</html>");

    CkStringBuilder sbResponse;
    sbResponse.Append("HTTP/1.1 200 OK\r\n");
    sbResponse.Append("Content-Length: ");
    sbResponse.AppendInt(sbResponseHtml.get_Length());
    sbResponse.Append("\r\n");
    sbResponse.Append("Content-Type: text/html\r\n");
    sbResponse.Append("\r\n");
    sbResponse.AppendSb(sbResponseHtml);

    sock.SendString(sbResponse.getAsString());
    sock.Close(50);

    //  The information we need is in the startLine.
    //  For example, the startLine will look like this:
    //   GET /?oauth_token=abcdRQAAZZAAxfBBAAABVabcd_k&oauth_verifier=9rdOq5abcdCe6cn8M3jabcdj3Eabcd HTTP/1.1
    CkStringBuilder sbStartLine;
    sbStartLine.Append(startLine);
    int numReplacements = sbStartLine.Replace("GET /?","");
    numReplacements = sbStartLine.Replace(" HTTP/1.1","");
    sbStartLine.Trim();

    //  oauth_token=qyprdP04IrTDIXtP1HRZz0geQdjXHVlGDxXPexlXZsjZNRcY&oauth_verifier=arx5pj5&realmId=193514465596199&dataSource=QBO
    std::cout << "startline: " << sbStartLine.getAsString() << "\r\n";

    hashTab1.Clear();
    hashTab1.AddQueryParams(sbStartLine.getAsString());

    requestToken = hashTab1.lookupStr("oauth_token");
    const char *authVerifier = hashTab1.lookupStr("oauth_verifier");

    //  ------------------------------------------------------------------------------
    //  Finally , we must exchange the OAuth Request Token for an OAuth Access Token.

    http.put_OAuthToken(requestToken);
    http.put_OAuthVerifier(authVerifier);

    req.put_HttpVerb("POST");
    req.put_ContentType("application/x-www-form-urlencoded");

    success = http.HttpReq(accessTokenUrl,req,resp);
    if (success == false) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

    //  Make sure a successful response was received.
    if (resp.get_StatusCode() != 200) {
        std::cout << resp.statusLine() << "\r\n";
        std::cout << resp.header() << "\r\n";
        std::cout << resp.bodyStr() << "\r\n";
        return;
    }

    //  If successful, the resp.BodyStr contains something like this:
    //  oauth_token=12347455-ffffrrlaBdCjbdGfyjZabcdb5APNtuTPNabcdEpp&oauth_token_secret=RxxxxJ8mTzUhwES4xxxxuJyFWDN8ZfHmrabcddh88LmWE
    std::cout << resp.bodyStr() << "\r\n";

    CkHashtable hashTab2;
    hashTab2.AddQueryParams(resp.bodyStr());

    const char *accessToken = hashTab2.lookupStr("oauth_token");
    const char *accessTokenSecret = hashTab2.lookupStr("oauth_token_secret");

    //  The access token + secret is what should be saved and used for
    //  subsequent REST API calls.
    std::cout << "Access Token = " << accessToken << "\r\n";
    std::cout << "Access Token Secret = " << accessTokenSecret << "\r\n";

    //  Save this access token for future calls.
    CkJsonObject json;
    json.AppendString("oauth_token",accessToken);
    json.AppendString("oauth_token_secret",accessTokenSecret);

    //  Also save the realmId and dataSource from hashTab1.
    const char *realmId = hashTab1.lookupStr("realmId");
    std::cout << "realmId = " << realmId << "\r\n";
    const char *dataSource = hashTab1.lookupStr("dataSource");
    std::cout << "dataSource = " << dataSource << "\r\n";

    json.AppendString("realmId",realmId);
    json.AppendString("dataSource",dataSource);

    CkFileAccess fac;
    fac.WriteEntireTextFile("qa_data/tokens/quickbooks.json",json.emit(),"utf-8",false);

    std::cout << "Success." << "\r\n";
    }