![Introducing Enhanced Alert Actions and Triage Functionality](https://cdn.sanity.io/images/cgdhsj6q/production/fe71306d515f85de6139b46745ea7180362324f0-2530x946.png?w=800&fit=max&auto=format)
Product
Introducing Enhanced Alert Actions and Triage Functionality
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
ynab
Advanced tools
Readme
NOTE: The YNAB API is currently only available to Early Access users. If you are interested in requesting access before the API is generally available, please fill out this form.
Please read the YNAB API documentation for an overview of using the API and a complete list of available resources.
This client is generated using the Swagger Code Generator.
First, install the module with npm (or yarn):
npm install ynab
Then, depending upon your usage context, add a reference to it:
const ynab = require("ynab");
import * as ynab from "ynab";
The API supports Cross Origin Resource Sharing (CORS) for asynchronous browser requests from any origin.
The dist/browser/ynab.js
file (located in node_modules/ynab after installation) is specifically built to run in a browser / window context and exports ynab
variable to global namespace. No other dependencies are needed.
<script src="ynab.js" async></script>
...
<script>
var ynab = window.ynab;
</script>
To use this client, you must obtain an access token from the My Account area of the YNAB web application.
const accessToken = "b43439eaafe2_this_is_fake_b43439eaafe2";
const ynabAPI = new ynab.API(accessToken);
(async function() {
const budgetsResponse = await ynabAPI.budgets.getBudgets();
const budgets = budgetsResponse.data.budgets;
for (let budget of budgets) {
console.log(`Budget Name: ${budget.name}`);
}
})();
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 ynab = require("ynab");
const accessToken = "invalid_token";
const ynabAPI = new ynab.API(accessToken);
const budgetsResponse = ynabAPI.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"
// }
// }
});
See the examples folder for example usage scenarios.
The following methods are available in this library. For more details on parameters and usage, the TypeScript declaration file can be referenced.
Method | Description | |
---|---|---|
User | budgets.getUser() | Returns authenticated user information |
Budgets | budgets.getBudgets() | Returns budgets list with summary information |
budgets.getBudgetById(id) | Returns a single budget with all related entities | |
Accounts | accounts.getAccounts(budgetId) | Returns all accounts |
accounts.getAccountById(budgetId, id) | Returns a single account | |
Categories | categories.getCategories(budgetId) | Returns all categories grouped by category group. |
categories.getCategoryById(budgetId, id) | Returns a single category | |
Payees | payees.getPayees(budgetId) | Returns all payees |
payees.getPayeeById(budgetId, id) | Returns single payee | |
Payee Locations | payeeLocations.getPayeeLocations(budgetId) | Returns all payee locations |
payeeLocations.getPayeeLocationById(budgetId, id) | Returns a single payee location | |
payeeLocations.getPayeeLocationsByPayee(budgetId, id) | Returns all payee locations for the specified payee | |
Months | months.getBudgetMonths(budgetId) | Returns all budget months |
months.getBudgetMonth(budgetId, month) | Returns a single budget month | |
Transactions | transactions.getTransactions(budgetId) | Returns budget transactions |
transactions.getTransactionsByAccount(budgetId, id) | Returns all transactions for a specified account | |
transactions.getTransactionsByCategory(budgetId, id) | Returns all transactions for a specified category | |
transactions.getTransactionsById(budgetId, id) | Returns a single transaction | |
transactions.updateTransaction(budgetId, id, transaction) | Updates a transaction | |
transactions.createTransaction(budgetId, transaction) | Creates a new transaction | |
transactions.bulkCreateTransactions(budgetId, transactions) | Creates multiple transactions | |
Scheduled Transactions | scheduledTransactions.getScheduledTransactions(budgetId) | Returns all scheduled transactions |
scheduledTransactions.getScheduledTransactionById(budgetId, id) | Returns a single scheduled transaction |
There are several utilities available on the utils
export 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;
// Returns the current date (system timezone) in ISO 8601 format (i.e. '2015-12-15')
getCurrentDateInISOFormat(): string;
// Converts an ISO 8601 formatted string to a JS date object
convertFromISODateString(isoDateString: string): Date;
// Converts a milliunits amount to a currency amount
convertMilliUnitsToCurrencyAmount(milliunits: number, currencyDecimalDigits: number): number;
To build and compile:
npm install
npm run build
To run tests:
npm test
Copyright (c) 2018 You Need A Budget, LLC
Licensed under the Apache-2.0 license
FAQs
YNAB API Javascript (Node) Library
The npm package ynab receives a total of 574 weekly downloads. As such, ynab popularity was classified as not popular.
We found that ynab demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.