v1.5.0

Important

This release introduces a breaking change by removing the public behavior related to rate limiting information, which was previously provided via the X-Rate-Limit header. This change was necessary because the rate limiting code was rendering the library unusable.

Added: Delete Transactions Support

The lib now supports deleting transactions!
Big thanks to @snarlysodboxer for their contribution! 🍻

Removed: Rate Limiting Code

All code associated with the now-discontinued X-Rate-Limit response header is now gone.
A huge thanks to @mschilli and @tedpearson for contributing patches to address this change! 🍻

Note

The only way to determine if you’ve exceeded the rate limit is now by checking the id, name, and detail fields of the *api.Error.

From https://api.ynab.com/#rate-limiting:

An access token may be used for up to 200 requests per hour.

The limit is enforced within a rolling window. If an access token is used at 12:30 PM and for 199 more requests up to 12:45 PM and then hits the limit, any additional requests will be forbidden until enough time has passed for earlier requests to fall outside of the preceding one-hour window.

If you exceed the rate limit, an error response returns a 429 error:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json; charset=utf-8

{
  "error": {
    "id": "429"
    "name": "too_many_requests"
    "detail": "Too many requests"
  }
}

Update package name

v1.4.0

Rename package

v1.3.0: Merge pull request #18 from brunomvsouza/api-documentation-sync

IMPORTANT:

• This release adds backwards incompatible changes in the budget package budget.DateFormat and budget.CurrencyFormat are now nullable in YNAB API's return.

• This release adds the ability to fetch and update category data for a given budget month.

With these two changes I believe the lib supports 100% of the YNAB API again.

v1.2.2

Add maintained badge

Soft-deprecating bulk transaction and replacing it by new endpoint

IMPORTANT: This change adds backwards incompatible changes. CreateTransaction return type have changed due to YNAB API changes. Should be easy to adjust though.

These changes were needed following a change on YNAB's API:

"We’ve soft-deprecated POST /budgets/{budget_id}/transactions/bulk. It still works and we still support it, but POST /budgets/{budget_id}/transactions with a transactions array is likely the more future-proof way of creating multiple transactions."

Source: https://www.youneedabudget.com/release-notes/

v1.1.8: Merge pull request #10 from brunomvsouza/add-last-used-budget-support

Add support to easily fetch last used budget

v1.1.7: Merge pull request #8 from brunomvsouza/documentation

Add licence on files and package descriptions

v1.1.6: Merge pull request #7 from dwburke/goal-more-than-100-percent

Fix of percentage can be higher than 100 thank you @dwburke for the contribution.

v1.1.5: Merge pull request #6 from brunomvsouza/fix-transaction-creation

Important fixes on transaction's persistence requests.

v1.1.4

vgo support