(Delphi ActiveX) Get eBay Application Token

This example shows how to request an eBay Application token.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat for Delphi Downloads Chilkat ActiveX DLL for Delphi Chilkat non-ActiveX DLL for Delphi * The examples here use the ActiveX DLL.

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
success: Integer;
http: TChilkatHttp;
req: TChilkatHttpRequest;
endPoint: WideString;
resp: TChilkatHttpResponse;
json: TChilkatJsonObject;
accessToken: WideString;
dtExpire: TCkDateTime;
fac: TCkFileAccess;

begin
success := 0;

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// See the Ebay documentation about Access token types
// Also see the Ebay documentation about client credentials grant flow

http := TChilkatHttp.Create(Self);

// If using the sandbox, the target endpoint will be:
// POST https://api.sandbox.ebay.com/identity/v1/oauth2/token

// If using the production (live) system, the target endpoint will be:
// POST https://api.ebay.com/identity/v1/oauth2/token

// The eBay client_id and client_secret needs to be sent
// in a Basic Authorization  request header, which has this format:
// Authorization: Basic <B64_encoded_oauth_credentials>

// Chilkat takes care of it.  You only need to set the Login = client_id,
// and password = client_secret, and indicate you want "Basic" HTTP Authorization.
http.Login := 'EBAY_CLIENT_ID';
http.Password := 'EBAY_CLIENT_SECRET';
http.BasicAuth := 1;

// Let's do the following POST:

//   HTTP method:   POST
//   URL (Sandbox): https://api.sandbox.ebay.com/identity/v1/oauth2/token
// 
//   HTTP headers:
//     Content-Type = application/x-www-form-urlencoded
//     Authorization = Basic <B64-encoded-oauth-credentials>
// 
//   Request body (wrapped for readability):
//     grant_type=client_credentials&
//     redirect_uri=<RuName-value>&
//     scope=<SPACE separated list of scopes>
// 

// Create an HttpRequest object to hold the request params.
req := TChilkatHttpRequest.Create(Self);
req.HttpVerb := 'POST';
req.AddParam('grant_type','client_credentials');

// The scope query param indicates the access to be provided by the token.
// Multiple scopes can be specified by separating each with a SPACE char.
// See the Ebay OAuth scopes documentation

req.AddParam('scope','https://api.ebay.com/oauth/api_scope');

endPoint := 'https://api.sandbox.ebay.com/identity/v1/oauth2/token';
req.ContentType := 'application/x-www-form-urlencoded';

resp := TChilkatHttpResponse.Create(Self);
success := http.HttpReq(endPoint,req.ControlInterface,resp.ControlInterface);
if (success = 0) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    Exit;
  end;

// The response is JSON..
json := TChilkatJsonObject.Create(Self);
json.Load(resp.BodyStr);
json.EmitCompact := 0;

// If the response status code is not 200, then it failed.
Memo1.Lines.Add('Response status code = ' + IntToStr(resp.StatusCode));
if (resp.StatusCode <> 200) then
  begin
    Memo1.Lines.Add(json.Emit());
    Memo1.Lines.Add('Failed.');
    Exit;
  end;

// We successfully retrieved an eBay access token.
// The actual access token string can be parsed from the JSON like this:
accessToken := json.StringOf('access_token');

// This application token is only valid for 7200 seconds (2 hours).  We'll want to refresh
// it before it expires.  (There is an online example for that..)
// For now, let's save the JSON to a file for our application to use.

// But before doing that, let's add to the JSON an expiration timestamp
// so we know when to refresh the token.
dtExpire := TCkDateTime.Create(Self);
dtExpire.SetFromCurrentSystemTime();
dtExpire.AddSeconds(json.IntOf('expires_in'));
json.AppendString('expire_time',dtExpire.GetAsTimestamp(0));

// Persist the JSON to a file.
fac := TCkFileAccess.Create(Self);
success := fac.WriteEntireTextFile('qa_data/tokens/ebay.json',json.Emit(),'utf-8',0);
if (success <> 1) then
  begin
    Memo1.Lines.Add(fac.LastErrorText);
    Memo1.Lines.Add('Failed to save eBay Application token to file.');
    Exit;
  end;

Memo1.Lines.Add(json.Emit());
Memo1.Lines.Add('Success.');

// The output of this example is:

// 	{ 
// 	  "access_token": "v^1.1#i^1#p^1#I^3#r^0# ... Ajp1BQhJDgAA",
// 	  "token_type": "Application Access Token",
// 	  "expires_in": 7200,
// 	  "refresh_token": "N/A",
// 	  "expire_time": "2017-04-16T14:44:20Z"
// 	}
// 
// 	Success.
// 
end;