README
xero-node-bankfeeds
Release of SDK with oAuth 2 support
Beta version 0.9.x of xero-node-bankfeeds SDK supports oAuth2 authentication with bank feeds API.
Usage
Installation This SDK is published as an npm package called xero-node-bankfeeds.
npm install --save xero-node-bankfeeds
Getting Started
Create a Xero App
Follow these steps to create your Xero app
- Create a free Xero user account (if you don't have one)
- Login to Xero developer center
- Click "Try oAuth2" link
- Enter your App name, company url, privacy policy url.
- Enter the redirect URI (this is your callback url - localhost, etc)
- Agree to terms and condition and click "Create App".
- Click "Generate a secret" button.
- Copy your client id and client secret and save for use later.
- Click the "Save" button. You secret is now hidden.
Typescript example
A "kitchen sync" app is available that demonstrates interacting with "feedconnections" endpoint. Just download the code and configure.
Javascript Example
This is a barebones example showing how to authenticate and display the name of the Xero organisation you've connected to.
Start with an empty folder
Initialze your app
npm init
Install dependencies
npm install --save xero-node-bankfeeds
npm install express --save
npm install express-session --save
Create your index.js using the code below - don't forget to add your client id and secret
'use strict';
const express = require('express');
const session = require('express-session');
const xero_node_bankfeeds = require('xero-node-bankfeeds');
const client_id = 'YOUR-CLIENT_ID'
const client_secret = 'YOUR-CLIENT_SECRET'
const redirectUri = 'http://localhost:5000/callback'
const scopes = 'openid profile email bankfeeds offline_access'
const xeroClient = new xero_node_bankfeeds.XeroBankFeedClient({
clientId: client_id,
clientSecret: client_secret,
redirectUris: [redirectUri],
scopes: scopes.split(" "),
});
let app = express()
app.set('port', (process.env.PORT || 3000))
app.use(express.static(__dirname + '/public'))
app.use(session({
secret: 'something crazy',
resave: false,
saveUninitialized: true,
cookie: { secure: false }
}));
app.get('/', function(req, res) {
res.send('<a href="/connect">Connect to Xero</a>');
})
app.get('/connect', async function(req, res) {
try {
let consentUrl = await xeroClient.buildConsentUrl();
res.redirect(consentUrl);
} catch (err) {
res.send("Sorry, something went wrong");
}
})
app.get('/callback', async function(req, res) {
const url = "http://localhost:5000/" + req.originalUrl;
await xeroClient.setAccessTokenFromRedirectUri(url);
// Optional: read user info from the id token
let tokenClaims = await xeroClient.readIdTokenClaims();
const accessToken = await xeroClient.readTokenSet();
req.session.tokenClaims = tokenClaims;
req.session.accessToken = accessToken;
res.redirect('/feedconnections');
})
app.get('/feedconnections', async function(req, res) {
try {
const accessToken = req.session.accessToken;
await xeroClient.setTokenSet(accessToken);
// CREATE
var feedConnection = new xero_node_bankfeeds.FeedConnection();
feedConnection.accountName = "SDK Test Account";
feedConnection.accountNumber = "123321";
feedConnection.accountToken = "foobar321";
feedConnection.accountType = xero_node_bankfeeds.FeedConnection.AccountTypeEnum.BANK;
feedConnection.currency = xero_node_bankfeeds.CurrencyCode.GBP;
const feedConnections = new xero_node_bankfeeds.FeedConnections();
feedConnections.items = [feedConnection];
const response = await xeroClient.bankFeedsApi.createFeedConnections(xeroClient.tenantIds[0], feedConnections);
res.send("Bank account create with ID: " + response.body.items[0].id );
} catch (err) {
console.log(err.body);
res.send("Sorry, something went wrong");
}
})
const PORT = process.env.PORT || 5000;
app.listen(PORT, function() {
console.log("Your Xero basic public app is running at localhost:" + PORT)
})
Project Structure
src/
|- gen/ autogenerated TypeScript
`- *.ts handwritten TypeScript
dist/ compiled JavaScript
package.json