added
2016-01-18
over 4 years ago by Bankin'
See all the modifications about this API version. Our current one is the 2018-06-15.
When we make backwards incompatible changes to the API, we release a new version with a new date.
The following changes are considered backwards incompatible:
- Adding new API endpoints
- Adding new properties to the responses from existing API endpoints
- Adding optional request parameters to existing API endpoints
- Altering the format or length of IDs
- Altering the message attributes returned by validation failures / other errors
Note that this changelog only reflects backwards incompatible updates so make sure you’ve subscribed to our API updates to keep up with new features.
All requests must specify a Bankin-Version
header.
curl "https://sync.bankin.com/v2/banks?client_id=TOP_SECRET_CLIENT_ID" \
-H 'Bankin-Version: 2016-01-18'
2016-01-18
Beta 4
Removed
- The Add an item and Edit an item were deprecated in last beta in favor of the new bank form (see connect an item and edit an item). The endpoints will be removed this beta.
Security
- Increased API security by adding the following security headers:
X-Frame-Options: DENY
to prevent clickjacking attacks, by ensuring that their content is not embedded into other sites.X-XSS-Protection: 1; mode=block
to enable browser XSS filter.Content-Security-Policy: default-src 'self'; img-src https://*.bankin.com
to control the resources the browser is allowed to load.
Enhancements
- Moved Get an item's refresh status URL from
/v2/items/:id/status
to/v2/items/:id/refresh/status
. - Added the possibility to specify a
redirect_url
on the bank form when using the sandbox credentials only. - Added the
user_uuid
in addition to theitem_id
to the bank form callback. - Updated the Terms of Service displayed in the bank form.
- Category names are now translated based on the provided
Accept-Language
header. Currently, we only support(
Accept-Language: fr
) and(
Accept-Language: en
). - Added new endpoint to list all user's items
- Added new endpoint to change a user's password
- Added the
loan_details
field to the Account resource. This field may contain data iftype
=loan
. - Added the
savings_details
field to to the Account resource. This field may contain data iftype
=savings
. - Added three new stocks endpoint to the API at the address in order to retrieve a user's stocks
- GET a single stock
v2/stocks/:stock_id
- GET all stocks paginated
v2/stocks
- GET all stocks since timestamp paginated
v2/stocks/updated
- GET a single stock
Beta 3
Deprecated
- The Add an item and Edit an item are deprecated in favor of the new bank form (see connect an item and edit an item). The endpoints will be removed on the next beta.
Enhancements
- Added a new bank form to connect items or edit an item's credentials.
- Added a new endpoint that returns transactions that were updated by the API since a moment in time: list updated transactions.
- All timestamps returned by the API now contain the milliseconds (i.e
updated_at
(account resource or transaction resource) is now returned as2016-06-21T10:09:10.473Z
instead of2016-06-21T10:09:10Z
).
Bug Fixes
- Transaction's
description
andraw_description
now contain the correct information.
Beta 2
Enhancements
- Added sandbox environment.
- Changed authentication process by adding a new
client_secret
parameter.
Refactor
- Moved authentication's user fields to a
user
object.