Chilkat Examples

ChilkatHOMEAndroid™Classic ASPCC++C#Mono C#.NET Core C#C# UWP/WinRTDataFlexDelphi ActiveXDelphi DLLVisual FoxProJavaLianjaMFCObjective-CPerlPHP ActiveXPHP ExtensionPowerBuilderPowerShellPureBasicCkPythonChilkat2-PythonRubySQL ServerSwift 2Swift 3/4TclUnicode CUnicode C++Visual Basic 6.0VB.NETVB.NET UWP/WinRTVBScriptXojo PluginNode.jsExcelGo

Perl Web API Examples

Primary Categories

AWS Translate
Activix CRM
Adyen
Amazon MWS
Azure Maps
Azure Monitor
Azure OAuth2
Azure Storage Accounts
Bluzone
CardConnect
ClickBank
Clickatell
Cloudfare
DocuSign
ETrade
Etsy
Facebook
GeoOp
GetHarvest
Jira
MYOB

Magento
Microsoft Calendar
Microsoft Group
Microsoft Tasks and Plans
Okta OAuth/OIDC
OneLogin OIDC
PayPal
Peoplevox
Populi
QuickBooks
SOAP finkok.com
Shippo
Shopify
Stripe
SugarCRM
Trello
Twitter
VoiceBase
Vonage
Walmart
Walmart v3
Xero
eBay
effectconnect

 

 

 

(Perl) Xero API through an SSH Tunnel

This example demonstrates connecting through an SSH Tunnel w/ 2-legged OAuth for a Xero private application.

This example requires Chilkat v9.5.0.64 or later

Chilkat Perl Downloads

Perl Module for Windows, Linux, Alpine Linux,
MAC OS X, Solaris, FreeBSD, OpenBSD,
Raspberry Pi and other single board computers

use chilkat();

# This example requires Chilkat v9.5.0.64 or later

$tunnel = chilkat::CkSocket->new();

$sshHostname = "www.my-ssh-server.com";
$sshPort = 22;

# Connect to an SSH server and establish the SSH tunnel:
$success = $tunnel->SshOpenTunnel($sshHostname,$sshPort);
if ($success != 1) {
    print $tunnel->lastErrorText() . "\r\n";
    exit;
}

# Authenticate with the SSH server via a login/password
# or with a public key.
# This example demonstrates SSH password authentication.
$success = $tunnel->SshAuthenticatePw("mySshLogin","mySshPassword");
if ($success != 1) {
    print $tunnel->lastErrorText() . "\r\n";
    exit;
}

#  OK, the SSH tunnel is setup.  Now open a channel within the tunnel.
#  (Any number of channels may be created from the same SSH tunnel.
#  Multiple channels may coexist at the same time.)

# This sample code would typically be placed in a subroutine or function
# where the rest object is passed by reference.
# It does the OAuth1 setup and makes the initial connection.
$rest = chilkat::CkRest->new();

$bTls = 1;
$port = 443;
$maxWaitMs = 7000;

# This returns a socket object that is a single channel within the SSH tunnel.
# channel is a Socket
$channel = $tunnel->SshOpenChannel("api.xero.com",$port,$bTls,$maxWaitMs);
if ($tunnel->get_LastMethodSuccess() != 1) {
    print $tunnel->lastErrorText() . "\r\n";
    exit;
}

# Use the connection.  (This connection is a TLS running on an SSH channel through an SSH tunnel.
# In other words, TLS is wrapped within the SSH tunnel.)
$success = $rest->UseConnection($channel,1);
if ($success != 1) {
    print $rest->lastErrorText() . "\r\n";

    exit;
}

# OK, we're connected.  
# -----------------------------------------------------------------
# Now setup the OAuth1 authenticator..

$consumerKey = "XERO_PRIVATE_APP_KEY";
$consumerSecret = "XERO_PRIVATE_APP_SECRET";

# Let's get our private key from our PFX (password protected), or the PEM (unprotected).
# You can decide which to use.  Either is OK, although I would recommend keeping your
# private keys in a PFX and not in an unprotected PEM.
$pfx = chilkat::CkPfx->new();
$success = $pfx->LoadPfxFile("qa_data/certs/xero_private_app/public_privatekey.pfx","PFX_PASSWORD");
if ($success != 1) {
    print $pfx->lastErrorText() . "\r\n";
    exit;
}

# privKeyFromPfx is a PrivateKey
$privKeyFromPfx = $pfx->GetPrivateKey(0);
if ($pfx->get_LastMethodSuccess() != 1) {
    print $pfx->lastErrorText() . "\r\n";
    exit;
}

# Or we can load from a PEM..
$privKeyFromPem = chilkat::CkPrivateKey->new();
$success = $privKeyFromPem->LoadPemFile("qa_data/certs/xero_private_app/privatekey.pem");
if ($success != 1) {
    print $privKeyFromPem->lastErrorText() . "\r\n";
    exit;
}

# Note: There are many other means for loading a private key, including
# from other formats and directly from memory (i.e. not file-based).

$oauth1 = chilkat::CkOAuth1->new();
$oauth1->put_ConsumerKey($consumerKey);
$oauth1->put_ConsumerSecret($consumerSecret);
$oauth1->put_Token($consumerKey);
$oauth1->put_TokenSecret($consumerSecret);
$oauth1->put_SignatureMethod("RSA-SHA1");
$oauth1->SetRsaKey($privKeyFromPfx);

# Install the OAuth1 authenticator.
$rest->SetAuthOAuth1($oauth1,0);

print "OK, the Xero OAuth1 is initialized and the REST object is ready to make REST API calls.." . "\r\n";

# -----------------------------------------------------------------
# Make a call to verify that OAuth1 through an HTTP proxy works..

# Get the full list of contacts.
$sbXml = chilkat::CkStringBuilder->new();
$success = $rest->FullRequestNoBodySb("GET","/api.xro/2.0/Contacts",$sbXml);
if ($success != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

# A 200 response is expected for actual success.
if ($rest->get_ResponseStatusCode() != 200) {
    print $sbXml->getAsString() . "\r\n";
    exit;
}

# Iterate over the contacts..
$bAutoTrim = 0;
$xml = chilkat::CkXml->new();
$xml->LoadSb($sbXml,$bAutoTrim);
$xml->SaveXml("qa_cache/xero_contacts.xml");

# How many records exist?
$recordCount = $xml->NumChildrenAt("Contacts");
print "numRecords = " . $recordCount . "\r\n";

$i = 0;
while ($i < $recordCount) {
    $xml->put_I($i);
    print "ContactID: " . $xml->getChildContent("Contacts|Contact[i]|ContactID") . "\r\n";
    $i = $i + 1;
}


 

© 2000-2019 Chilkat Software, Inc. All Rights Reserved.