Package Exports
- ynab
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ynab) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
YNAB API Javascript (Node) Library
The YNAB API JavaScript library provides access to the YNAB API from applications written in Node.js / JavaScript.
Please read the YNAB API documentation for an overview of using the API and a complete list of the available resources.
Installation
npm install ynabUsage
To use this client, you must obtain an access token from the My Account area of the YNAB web application.
const ynabApi = require("ynab");
const accessToken = "b43439eaafe2_this_is_fake_b43439eaafe2";
const ynab = new ynabApi(accessToken);
async function listBudgets(){
const budgetsResponse = await ynab.budgets.getBudgets();
const budgets = budgetsResponse.data.budgets;
for(let budget of budgets) {
console.log(`Budget Name: ${budget.name}`);
}
}
listBudgets();Error Handling
If a response is returned with a code >= 300, instead of returning the response, the response will be "thrown" as an error to be caught.
const ynabApi = require("ynab-sdk-js");
const accessToken = "invalid_token";
const ynab = new ynabApi(accessToken);
const budgetsResponse = ynab.budgets.getBudgets()
.then(budgetsResponse => {
// Won't get here because an error will be thrown
})
.catch(e => {
console.log(e);
// {
// error: {
// id: "401",
// name: "unauthorized",
// detail: "Unauthorized"
// }
// }
});Utilities
There are several utilities available on the ynab.utils object to make working
with ISO dates and milliunits a bit
easier.
/**
* Returns the current month (system timezone) in ISO 8601 format (i.e. '2015-12-01')
*/
getCurrentMonthInISOFormat(): string;
/**
* Converts an ISO 8601 formatted string to a JS date object
* @param {string} isoDate - An ISO 8601 formatted date (i.e. '2015-12-30'). This date is assumed to be in UTC timezone
*/
convertFromISODateString(isoDateString: string): Date;
/**
* Converts a milliunits amount to a currency amount
* @param milliunits - The milliunits amount (i.e. 293294)
* @param currencyDecimalDigits - The number of decimals in the currency (i.e. 2 for USD)
*/
convertMilliUnitsToCurrencyAmount(milliunits: number, currencyDecimalDigits: number): number;Examples
See the examples folder for example usage scenarios.
Development
To build and compile:
npm install
npm run buildTo run tests:
npm testLicense
Copyright (c) 2018 You Need A Budget, LLC
Licensed under the Apache-2.0 license