budgea_client 1.4.4 → 2.0.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Gemfile.lock +5 -5
- data/README.md +67 -725
- data/budgea_client.gemspec +15 -3
- data/budgea_openapi.json +2011 -524
- data/docs/Account.md +3 -1
- data/docs/AccountLog.md +2 -2
- data/docs/AdministrationApi.md +354 -34
- data/docs/AuthenticationApi.md +264 -18
- data/docs/BankCategory.md +1 -1
- data/docs/BanksApi.md +939 -550
- data/docs/Certificate.md +12 -0
- data/docs/Client.md +5 -2
- data/docs/Connection.md +1 -1
- data/docs/ConnectionLog.md +3 -2
- data/docs/ConnectionsApi.md +162 -103
- data/docs/Connector.md +21 -0
- data/docs/ConnectorCategory.md +9 -0
- data/docs/ConnectorLogo.md +1 -1
- data/docs/Currency.md +4 -0
- data/docs/DocumentsApi.md +350 -350
- data/docs/Field.md +3 -2
- data/docs/InlineResponse20010.md +1 -1
- data/docs/InlineResponse20011.md +1 -1
- data/docs/InlineResponse20012.md +1 -1
- data/docs/InlineResponse20013.md +1 -1
- data/docs/InlineResponse20014.md +1 -1
- data/docs/InlineResponse20015.md +1 -1
- data/docs/InlineResponse20016.md +1 -1
- data/docs/InlineResponse20017.md +1 -1
- data/docs/InlineResponse20018.md +1 -1
- data/docs/InlineResponse20019.md +1 -1
- data/docs/InlineResponse20020.md +1 -1
- data/docs/InlineResponse20021.md +1 -1
- data/docs/InlineResponse20022.md +1 -1
- data/docs/InlineResponse20023.md +1 -1
- data/docs/InlineResponse20024.md +1 -1
- data/docs/InlineResponse20025.md +1 -1
- data/docs/InlineResponse20026.md +1 -1
- data/docs/InlineResponse20027.md +1 -1
- data/docs/InlineResponse20028.md +1 -1
- data/docs/InlineResponse20029.md +1 -1
- data/docs/InlineResponse2003.md +2 -3
- data/docs/InlineResponse20030.md +1 -1
- data/docs/InlineResponse20031.md +1 -1
- data/docs/InlineResponse20032.md +1 -1
- data/docs/InlineResponse20033.md +1 -1
- data/docs/InlineResponse20034.md +8 -0
- data/docs/InlineResponse20035.md +8 -0
- data/docs/InlineResponse20036.md +8 -0
- data/docs/InlineResponse2004.md +0 -2
- data/docs/InlineResponse2005.md +5 -2
- data/docs/InlineResponse2006.md +2 -3
- data/docs/InlineResponse2007.md +3 -1
- data/docs/InlineResponse2008.md +1 -1
- data/docs/InlineResponse2009.md +1 -1
- data/docs/OCRApi.md +5 -5
- data/docs/OIDCApi.md +5 -5
- data/docs/PFMApi.md +122 -122
- data/docs/Pocket.md +1 -1
- data/docs/Profile.md +1 -1
- data/docs/Project.md +1 -1
- data/docs/ProvidersApi.md +602 -604
- data/docs/Recipient.md +3 -0
- data/docs/RecipientLog.md +14 -0
- data/docs/RecipientsApi.md +28 -20
- data/docs/Subscription.md +2 -1
- data/docs/TermsApi.md +13 -15
- data/docs/Transaction.md +8 -3
- data/docs/Transfer.md +1 -0
- data/docs/TransferLog.md +14 -0
- data/docs/TransfersApi.md +165 -141
- data/docs/UserAlert.md +2 -2
- data/docs/UsersManagementApi.md +24 -24
- data/docs/WealthApi.md +54 -54
- data/docs/WebhookLog.md +15 -0
- data/lib/budgea_client.rb +27 -3
- data/lib/budgea_client/api/administration_api.rb +425 -106
- data/lib/budgea_client/api/authentication_api.rb +287 -46
- data/lib/budgea_client/api/banks_api.rb +1271 -974
- data/lib/budgea_client/api/connections_api.rb +207 -156
- data/lib/budgea_client/api/documents_api.rb +627 -693
- data/lib/budgea_client/api/ocr_api.rb +24 -16
- data/lib/budgea_client/api/oidc_api.rb +23 -16
- data/lib/budgea_client/api/pfm_api.rb +219 -248
- data/lib/budgea_client/api/providers_api.rb +998 -1099
- data/lib/budgea_client/api/recipients_api.rb +52 -34
- data/lib/budgea_client/api/terms_api.rb +34 -31
- data/lib/budgea_client/api/transfers_api.rb +245 -239
- data/lib/budgea_client/api/users_management_api.rb +56 -58
- data/lib/budgea_client/api/wealth_api.rb +81 -85
- data/lib/budgea_client/api_client.rb +20 -11
- data/lib/budgea_client/api_error.rb +11 -1
- data/lib/budgea_client/configuration.rb +12 -2
- data/lib/budgea_client/models/access.rb +18 -13
- data/lib/budgea_client/models/account.rb +44 -23
- data/lib/budgea_client/models/account_log.rb +33 -28
- data/lib/budgea_client/models/account_type.rb +22 -17
- data/lib/budgea_client/models/alert.rb +21 -16
- data/lib/budgea_client/models/bank.rb +21 -16
- data/lib/budgea_client/models/bank_category.rb +19 -14
- data/lib/budgea_client/models/category.rb +22 -17
- data/lib/budgea_client/models/certificate.rb +244 -0
- data/lib/budgea_client/models/client.rb +53 -20
- data/lib/budgea_client/models/connection.rb +29 -24
- data/lib/budgea_client/models/connection_log.rb +39 -24
- data/lib/budgea_client/models/connector.rb +345 -0
- data/lib/budgea_client/models/connector_category.rb +206 -0
- data/lib/budgea_client/models/connector_logo.rb +29 -24
- data/lib/budgea_client/models/currency.rb +63 -16
- data/lib/budgea_client/models/device.rb +23 -18
- data/lib/budgea_client/models/document.rb +21 -16
- data/lib/budgea_client/models/document_type.rb +19 -14
- data/lib/budgea_client/models/field.rb +44 -27
- data/lib/budgea_client/models/field_value.rb +18 -13
- data/lib/budgea_client/models/file.rb +20 -15
- data/lib/budgea_client/models/group.rb +17 -12
- data/lib/budgea_client/models/hash_table.rb +20 -15
- data/lib/budgea_client/models/inline_response_200.rb +17 -12
- data/lib/budgea_client/models/inline_response_200_1.rb +18 -13
- data/lib/budgea_client/models/inline_response_200_10.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_11.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_12.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_13.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_14.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_15.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_16.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_17.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_18.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_19.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_2.rb +18 -13
- data/lib/budgea_client/models/inline_response_200_20.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_21.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_22.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_23.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_24.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_25.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_26.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_27.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_28.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_29.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_3.rb +37 -47
- data/lib/budgea_client/models/inline_response_200_30.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_31.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_32.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_33.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_34.rb +190 -0
- data/lib/budgea_client/models/inline_response_200_35.rb +190 -0
- data/lib/budgea_client/models/inline_response_200_36.rb +190 -0
- data/lib/budgea_client/models/inline_response_200_4.rb +20 -40
- data/lib/budgea_client/models/inline_response_200_5.rb +75 -30
- data/lib/budgea_client/models/inline_response_200_6.rb +37 -47
- data/lib/budgea_client/models/inline_response_200_7.rb +55 -21
- data/lib/budgea_client/models/inline_response_200_8.rb +27 -22
- data/lib/budgea_client/models/inline_response_200_9.rb +27 -22
- data/lib/budgea_client/models/investment.rb +20 -15
- data/lib/budgea_client/models/investment_value.rb +20 -15
- data/lib/budgea_client/models/invite.rb +18 -13
- data/lib/budgea_client/models/locked_user.rb +18 -13
- data/lib/budgea_client/models/oidc_whitelist.rb +18 -13
- data/lib/budgea_client/models/pocket.rb +22 -17
- data/lib/budgea_client/models/profile.rb +26 -20
- data/lib/budgea_client/models/project.rb +26 -21
- data/lib/budgea_client/models/project_type.rb +18 -13
- data/lib/budgea_client/models/recipient.rb +52 -17
- data/lib/budgea_client/models/recipient_log.rb +254 -0
- data/lib/budgea_client/models/security.rb +18 -13
- data/lib/budgea_client/models/subscription.rb +31 -21
- data/lib/budgea_client/models/terms_of_service.rb +19 -14
- data/lib/budgea_client/models/transaction.rb +83 -33
- data/lib/budgea_client/models/transaction_information.rb +19 -14
- data/lib/budgea_client/models/transactions_cluster.rb +21 -16
- data/lib/budgea_client/models/transfer.rb +32 -16
- data/lib/budgea_client/models/transfer_log.rb +254 -0
- data/lib/budgea_client/models/user.rb +22 -16
- data/lib/budgea_client/models/user_alert.rb +22 -16
- data/lib/budgea_client/models/webhook.rb +19 -14
- data/lib/budgea_client/models/webhook_log.rb +264 -0
- data/lib/budgea_client/version.rb +12 -2
- data/original_budgea_openapi.json +23188 -0
- data/spec/models/certificate_spec.rb +65 -0
- data/spec/models/connector_category_spec.rb +47 -0
- data/spec/models/connector_spec.rb +119 -0
- data/spec/models/inline_response_200_34_spec.rb +41 -0
- data/spec/models/inline_response_200_35_spec.rb +41 -0
- data/spec/models/inline_response_200_36_spec.rb +41 -0
- data/spec/models/recipient_log_spec.rb +77 -0
- data/spec/models/transfer_log_spec.rb +77 -0
- data/spec/models/webhook_log_spec.rb +83 -0
- metadata +52 -18
- data/pkg/budgea_client-1.3.9.gem +0 -0
- data/pkg/budgea_client-1.4.2.gem +0 -0
- data/pkg/budgea_client-1.4.3.gem +0 -0
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 82f87ebb4e406ca9b617792c8e076c6d5f350f40f5c661456bb587ade23fd9e0
|
4
|
+
data.tar.gz: a22550592d6e6e7aad56bfb671dec5ee774b51beb64f5972643b6993b724ad20
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 1727f9741d67dc86a2e45a9638e2f802b210c9a67b88eaa2f2dbaaa0b9e6d3d6d1a0b374220f2f0a42d0907466295762bbc8f0400b3b8e614c1bfa5b1536b56b
|
7
|
+
data.tar.gz: 8f2ebeba2ad4d1054805c48ed352ce1bc2166e66a3d4a86007f8e2eb79d3f0656a535c4fa716b35d016348f4b7b82cddc6cfa9604beaac99aed2c2566118a53f
|
data/Gemfile.lock
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
PATH
|
2
2
|
remote: .
|
3
3
|
specs:
|
4
|
-
budgea_client (
|
4
|
+
budgea_client (2.0.0)
|
5
5
|
json (~> 2.1, >= 2.1.0)
|
6
6
|
typhoeus (~> 1.0, >= 1.0.1)
|
7
7
|
|
@@ -20,11 +20,11 @@ GEM
|
|
20
20
|
crack (0.4.3)
|
21
21
|
safe_yaml (~> 1.0.0)
|
22
22
|
diff-lcs (1.3)
|
23
|
-
ethon (0.
|
23
|
+
ethon (0.12.0)
|
24
24
|
ffi (>= 1.3.0)
|
25
25
|
ffi (1.9.25)
|
26
26
|
hashdiff (0.3.7)
|
27
|
-
json (2.
|
27
|
+
json (2.2.0)
|
28
28
|
public_suffix (3.0.3)
|
29
29
|
rake (12.0.0)
|
30
30
|
rspec (3.8.0)
|
@@ -43,7 +43,7 @@ GEM
|
|
43
43
|
safe_yaml (1.0.4)
|
44
44
|
sys-uname (1.0.3)
|
45
45
|
ffi (>= 1.0.0)
|
46
|
-
typhoeus (1.3.
|
46
|
+
typhoeus (1.3.1)
|
47
47
|
ethon (>= 0.9.0)
|
48
48
|
vcr (3.0.3)
|
49
49
|
webmock (1.24.6)
|
@@ -66,4 +66,4 @@ DEPENDENCIES
|
|
66
66
|
webmock (~> 1.24, >= 1.24.3)
|
67
67
|
|
68
68
|
BUNDLED WITH
|
69
|
-
1.16.
|
69
|
+
1.16.6
|
data/README.md
CHANGED
@@ -2,695 +2,7 @@
|
|
2
2
|
|
3
3
|
BudgeaClient - the Ruby gem for the Budgea API Documentation
|
4
4
|
|
5
|
-
|
6
|
-
|
7
|
-
Welcome to **Budgea**'s documentation.
|
8
|
-
This documentation is intended to get you up-and-running with our APIs and advise on the implementation of some
|
9
|
-
regulatory aspects of your application, following the DSP2's guidelines.
|
10
|
-
## Getting Started **IMPORTANT** Depending on your status with regard of the DSP2 regulation, **agent** or **partner**,
|
11
|
-
you may call our APIs or simply use our Webview and callbacks to get the financial data of your users. As an **agent**,
|
12
|
-
you are allowed to call directly our APIs and implement your own form to get the user's credentials. As a **partner**,
|
13
|
-
you cannot manipulate the credentials, and have to delegate this step to us through our webview.
|
14
|
-
|
15
|
-
The sections below will document how to use our APIs, make sure you have the **agent** status to do so. For the
|
16
|
-
**partner**, please refer to the section *Webview* and *Callbacks* of this documentation.
|
17
|
-
|
18
|
-
### Overview
|
19
|
-
Your API is a REST API which requires a communication through https to send and receive JSON documents. During your
|
20
|
-
tests, we recommend to make calls to the API with curl or any other HTTP client of your choice.
|
21
|
-
You can watch a video demonstration on this [URL](https://asciinema.org/a/FsaFyt3WAPyDm7sfaZPkwal3V). For the examples
|
22
|
-
we'll use the demo API with adress `https://demo.biapi.pro`, you should change that name to your API's name.
|
23
|
-
|
24
|
-
### Hello World
|
25
|
-
Let's start by calling the service `/banks` which lists all available banks.
|
26
|
-
``` curl -X GET \\
|
27
|
-
https://demo.biapi.pro/2.0/banks/
|
28
|
-
```
|
29
|
-
|
30
|
-
To log in to a bank webpage, you'll need to know for a given bank, the fields your user should fill in the form.
|
31
|
-
Let's call a specific bank and ask for an additional resource *fields*.
|
32
|
-
``` curl -X GET \\
|
33
|
-
https://demo.biapi.pro/2.0/banks/59?expand=fields
|
34
|
-
```
|
35
|
-
The response here concerns only 1 bank (since we specified an id) and the resource _Fields_ is added to the response
|
36
|
-
thanks to the query parameter `expand`.
|
37
|
-
|
38
|
-
To get more interesting things done, you'll need to send authenticated requests.
|
39
|
-
|
40
|
-
### Authentication
|
41
|
-
The way to authenticate is by passing the `Authorization: Bearer <token>` header in your request. At the setup
|
42
|
-
a _manage token_ have been generated, you can use this token for now, when creating your user we'll see how to
|
43
|
-
generate a user's token.
|
44
|
-
``` curl -X GET \\
|
45
|
-
https://demo.biapi.pro/2.0/config \\
|
46
|
-
-H 'Authorization: Bearer <token>'
|
47
|
-
```
|
48
|
-
|
49
|
-
This endpoint will list all the parameters you can change to adapt Budgea to your needs.
|
50
|
-
We've covered the very first calls. Before diving deeper, let's see some general information about the APIs.
|
51
|
-
|
52
|
-
## Abstract
|
53
|
-
|
54
|
-
### API URL
|
55
|
-
|
56
|
-
`https://demo.biapi.pro/2.0`
|
57
|
-
|
58
|
-
### Requests format
|
59
|
-
Data format: **application/x-www-form-urlencoded** or **application/json** (suggested)
|
60
|
-
Additional headers: Authorization: User's token (private)
|
61
|
-
|
62
|
-
### Responses format
|
63
|
-
Data format: **application/json** ([http://www.json.org](http://www.json.org/)) Charset: **UTF-8**
|
64
|
-
### Resources
|
65
|
-
Each call on an endpoint will return resources. The main resources are:
|
66
|
-
|
67
|
-
| Resource | Description |
|
68
|
-
|---------------------|:------------------------------------------------------------------------------------------------------------------ |
|
69
|
-
|Users | Represent a user |
|
70
|
-
|Connection | A set of data used to authenticate on a website (usually a login and password). There is 1 connection for each website|
|
71
|
-
|Account | A bank account contained in a connection |
|
72
|
-
|Transaction | An entry in a bank account |
|
73
|
-
|Investment | An asset in a bank account |
|
74
|
-
|
75
|
-
The chain of resources is as follow: **Users ∈ Connections ∈ Accounts ∈ Transactions or Investments**
|
76
|
-
|
77
|
-
### RESTful API
|
78
|
-
This API is RESTful, which means it is stateless and each resource is accessed with an uniq URI.
|
79
|
-
|
80
|
-
Several HTTP methods are available:
|
81
|
-
|
82
|
-
| Method | Description |
|
83
|
-
| ------------------------|:-------------------------------|
|
84
|
-
| GET /resources | List resources |
|
85
|
-
| GET /resources/{ID} | Get a resource from its ID |
|
86
|
-
| POST /resources | Create a new resource |
|
87
|
-
| POST /resources/{ID} | Update a resource |
|
88
|
-
| PUT /resources /{ID} | Update a resource |
|
89
|
-
| DELETE /resources | Remove every resources |
|
90
|
-
| DELETE /resources/{ID} | Delete a resource |
|
91
|
-
|
92
|
-
Each resource can contain sub-resources, for example: `/users/me/connections/2/accounts/23/transactions/48`
|
93
|
-
|
94
|
-
### HTTP response codes
|
95
|
-
|
96
|
-
| Code | Message | Description |
|
97
|
-
| ----------- |:---------------------:|-----------------------------------------------------------------------------------------------|
|
98
|
-
| 200 | OK |Default response when a GET or POST request has succeed |
|
99
|
-
| 202 | Accepted |For a new connection this code means it is necessary to provide complementary information (2FA)|
|
100
|
-
| 204 | No content |Default response when a POST request succeed without content |
|
101
|
-
| 400 | Bad request |Supplied parameters are incorrect |
|
102
|
-
| 403 | Forbidden |Invalid token |
|
103
|
-
| 500 | Internal Servor Error |Server error |
|
104
|
-
| 503 | Service Unavailable |Service is temporarily unavailable |
|
105
|
-
|
106
|
-
### Errors management
|
107
|
-
|
108
|
-
In case an error occurs (code 4xx or 5xx), the response can contain a JSON object describing this error:
|
109
|
-
|
110
|
-
```json
|
111
|
-
{
|
112
|
-
"code": "authFailure",
|
113
|
-
"message": "Wrong password" // Optional
|
114
|
-
}
|
115
|
-
```
|
116
|
-
|
117
|
-
If an error is displayed on the website, Its content is returned in error_message field. The list of all possible
|
118
|
-
errors is listed further down this page.
|
119
|
-
|
120
|
-
### Authentication
|
121
|
-
A user is authenticated by an access_token which is sent by the API during a call on one of the
|
122
|
-
authentication services, and can be supplied with this header: `Authorization: Bearer YYYYYYYYYYYYYYYYYYYYYYYYYYY`
|
123
|
-
There are two user levels:
|
124
|
-
* Normal user, which can only access to his own accounts
|
125
|
-
* Administrator, with extended rights
|
126
|
-
|
127
|
-
### Default filters
|
128
|
-
|
129
|
-
During a call to an URI which lists resources, some filters can be passed as query parameters:
|
130
|
-
|
131
|
-
| Parameter | Type | Description |
|
132
|
-
| ----------- |:---------:|-----------------------------------------------------------|
|
133
|
-
| offset | Integer |Offset of the first returned resource |
|
134
|
-
| limit | Integer |Limit number of results |
|
135
|
-
| min_date | Date |Minimal date (if supported by service), format: YYYY-MM-DD |
|
136
|
-
| max_date | Date |Maximal date (if supported by service), format: YYYY-MM-DD |
|
137
|
-
|
138
|
-
### Extend requests
|
139
|
-
|
140
|
-
During a GET on a set of resources or on a unique resource, it is possible to add a parameter expand to the request
|
141
|
-
to extend relations with other resources:
|
142
|
-
|
143
|
-
`GET /2.0/users/me/accounts/123?expand=transactions[category],connection`
|
144
|
-
|
145
|
-
```json
|
146
|
-
{
|
147
|
-
"id": 123,
|
148
|
-
"name": "Compte chèque",
|
149
|
-
"balance": 1561.15,
|
150
|
-
"transactions": [
|
151
|
-
{
|
152
|
-
"id": 9849,
|
153
|
-
"simplified_wording": "HALL'S BEER",
|
154
|
-
"value": -513.20,
|
155
|
-
...,
|
156
|
-
"category": {
|
157
|
-
"id": 561,
|
158
|
-
"name": "Sorties / Bar",
|
159
|
-
...
|
160
|
-
}
|
161
|
-
},
|
162
|
-
...
|
163
|
-
],
|
164
|
-
"id_user": 1,
|
165
|
-
"connection": {
|
166
|
-
"id": 1518,
|
167
|
-
"id_bank": 41,
|
168
|
-
"id_user": 1,
|
169
|
-
"error": null,
|
170
|
-
...
|
171
|
-
}
|
172
|
-
}
|
173
|
-
```
|
174
|
-
|
175
|
-
### Request example
|
176
|
-
|
177
|
-
```http
|
178
|
-
GET /2.0/banks?offset=0&limit=10&expand=fields
|
179
|
-
Host: demo.biapi.pro
|
180
|
-
Accept: application/json
|
181
|
-
Authorization: Bearer <token>
|
182
|
-
```
|
183
|
-
|
184
|
-
```http
|
185
|
-
HTTP/1.1 200 OK
|
186
|
-
Content-Type: application/json
|
187
|
-
Content-Length: 3026
|
188
|
-
Server: Apache
|
189
|
-
Date: Fri, 14 Mar 2014 08:24:02 GMT
|
190
|
-
{ \"banks\" : [ { \"id_weboob\" : \"bnporc\", \"name\" : \"BNP Paribas\", \"id\" : 3, \"hidden\" : false, \"fields\" : [ { \"id\" : 1, \"id_bank\" : 3, \"regex\" : \"^[0-9]{5,10}$\", \"name\" : \"login\", \"type\" : \"text\", \"label\" : \"Numéro client\" }, { \"id\" : 2, \"id_bank\" : 3, \"regex\" : \"^[0-9]{6}$\", \"name\" : \"password\", \"type\" : \"password\", \"label\" : \"Code secret\" } ] }, ... ] \"total\" : 41 }
|
191
|
-
```
|
192
|
-
|
193
|
-
### Constants
|
194
|
-
|
195
|
-
#### List of bank account types
|
196
|
-
|
197
|
-
| Type |Description |
|
198
|
-
| ----------- |-----------------------------------|
|
199
|
-
| checking |Checking account |
|
200
|
-
| savings |Savings account |
|
201
|
-
| deposit |Deposit accounts |
|
202
|
-
| loan |Loan |
|
203
|
-
| market | Market accounts |
|
204
|
-
| joint |Joint account |
|
205
|
-
| card |Card |
|
206
|
-
| lifeinsurance |Life insurance accounts |
|
207
|
-
| pee |Plan Épargne Entreprise |
|
208
|
-
| perco |Plan Épargne Retraite |
|
209
|
-
| article83 |Article 83 |
|
210
|
-
| rsp |Réserve spéciale de participation |
|
211
|
-
| pea |Plan d'épargne en actions |
|
212
|
-
| capitalisation|Contrat de capitalisation |
|
213
|
-
| perp |Plan d'épargne retraite populaire |
|
214
|
-
| madelin |Contrat retraite Madelin |
|
215
|
-
| unknown |Inconnu |
|
216
|
-
|
217
|
-
#### List of transaction types
|
218
|
-
|
219
|
-
| Type |Description |
|
220
|
-
| ----------- |-----------------------------------|
|
221
|
-
|transfer |Transfers |
|
222
|
-
|order |Orders |
|
223
|
-
|check |Checks |
|
224
|
-
|deposit |Cash deposit |
|
225
|
-
|payback |Payback |
|
226
|
-
|withdrawal |Withdrawal |
|
227
|
-
|loan_payment |Loan payment |
|
228
|
-
|bank |Bank fees |
|
229
|
-
|card |Card operation |
|
230
|
-
|deferred_card |Deferred card operation |
|
231
|
-
|card_summary |Mensual debit of a deferred card |
|
232
|
-
|
233
|
-
#### List of synchronization errors
|
234
|
-
|
235
|
-
| Error |Description |
|
236
|
-
| ----------------------- |------------------------------------------------------------------------------------- |
|
237
|
-
|wrongpass |The authentication on website has failed |
|
238
|
-
|additionalInformationNeeded |Additional information are needed |
|
239
|
-
|websiteUnavailable |The website is unavailable |
|
240
|
-
|actionNeeded |An action is needed on the website |
|
241
|
-
|bug |A bug has occurred during the synchronization. An alert has been sent to Budget Insight|
|
242
|
-
|
243
|
-
Now you know the basics of Budgea API
|
244
|
-
- Basic call to retrieve resources
|
245
|
-
- Add query parameters to aplly filters
|
246
|
-
- Expand resources
|
247
|
-
- Authenticated calls
|
248
|
-
|
249
|
-
We're good for the basics! Now let's see how to integrate Budgea in your app and create your first user.
|
250
|
-
|
251
|
-
## Integrate Budgea
|
252
|
-
|
253
|
-
### The workflow Users of your application exist in the Budgea API.
|
254
|
-
Every User is identified by an access_token which is the shared secret between your application and our API.
|
255
|
-
The workflow is as below:
|
256
|
-
|
257
|
-
1. The user is on your application and wants to share his bank accounts or invoices.
|
258
|
-
2. A call is made **client side** (browser's javascript or desktop application) to create a temporarily token which will be used to make API calls.
|
259
|
-
3. A form is built, allowing the user to select the connector to use (bank or provider, depending on context). Every connector requires different kind of credentials.
|
260
|
-
4. A call on the API is made with the temporarily token to add a **Connection** with the credentials supplied by user.
|
261
|
-
5. In case of success, the user chooses what bank accounts (**Account**) or subscriptions (**Subscription**) he wants to share with your application.
|
262
|
-
6. When he validates the share, the temporarily token is transmitted to your server.
|
263
|
-
|
264
|
-
This one will call the Budgea API with this token to get a permanent token.
|
265
|
-
|
266
|
-
**Note** In case your application works without a server (for example a desktop application), the permanent token can
|
267
|
-
be obtained on the 1st step, by supplying a client_secret to /autinit and the step 6 is omitted. To get more
|
268
|
-
information, read the protocol. There are 3 steps to integrate Budgea in your application:
|
269
|
-
1. Provide a way for your users to share their credentials with you
|
270
|
-
2. Get the data scraped from Budgea
|
271
|
-
3. Be sure to follow the good practices before going into production
|
272
|
-
|
273
|
-
### Get credentials from users
|
274
|
-
You have 2 options here:
|
275
|
-
- Integrate the Budget Insight's Webview, a turnkey solution to get user's credentials
|
276
|
-
- Create your own form following the protocol (must have the *agent* status)
|
277
|
-
|
278
|
-
#### Webview
|
279
|
-
|
280
|
-
The webview allows your users to give their bank or provider credentials to the safety third-party Budgea API.
|
281
|
-
It is responsive, which means it displays correctly on a desktop or a mobile device.
|
282
|
-
The API meets the standard [OAuth 2](http://tools.ietf.org/html/rfc6749) and any client library that implements it will
|
283
|
-
be able to facilitate the integration to the Budgea API. We provide PHP, Python and Ruby modules to facilitate the
|
284
|
-
integration.
|
285
|
-
|
286
|
-
|Language | Library |
|
287
|
-
|-----------------|---------------------------------------------------------------------------------------- |
|
288
|
-
|PHP |[BudgeaAPI.php](https://github.com/budgetinsight/budgea-clients/blob/master/BudgeaAPI.php)|
|
289
|
-
|PYTHON |[budgea_api.py](https://github.com/budgetinsight/budgea-clients/blob/master/budgea_api.py)|
|
290
|
-
|RUBY |[budgea.rb](https://github.com/budgetinsight/budgea-clients/blob/master/budgea.rb) |
|
291
|
-
|
292
|
-
To delegate to the Budgea API the management of the bank and provider credentials of your users, you have to
|
293
|
-
provide a button which redirects on the following page: `https://demo.biapi.pro/2.0/auth/share/`
|
294
|
-
|
295
|
-
You must first configure your client application. A client, in the OAuth 2 of the term, represents an application
|
296
|
-
accessing to the Budgea API. The parameters to supply to the URL are the following:
|
297
|
-
|
298
|
-
|Parameter |Description |
|
299
|
-
|---------------------|------------------------------------------------------------ |
|
300
|
-
|client_id |The client id of your application |
|
301
|
-
|redirect_uri |(optional) The adress where the user shoud be redirected after sharing his credentials. The adress must match the redirection URI set for the client |
|
302
|
-
|state |(optional) An arbitrary string sent back to you for control |
|
303
|
-
|types |The type of connectors (**banks** or **providers**) |
|
304
|
-
|connectors |(optional) Given a connector id, it will prefill the form |
|
305
|
-
|
306
|
-
You can use our libraries to generate this URL. It is also possible to get the HTML code of the button with
|
307
|
-
the libraries, the render is as below: ![Share your accounts button](https://demo.biapi.pro/2.0/auth/share/button_icon.png)
|
308
|
-
|
309
|
-
When the user confirms the share of his accounts with you, he is redirected to the callback URL you have defined. This one receives the following parameters:
|
310
|
-
|
311
|
-
|Parameter |Description |
|
312
|
-
|---------------------|-------------------------------------------------------------------------------------------------|
|
313
|
-
|code |A temporary token allowing you to get the **access_token** |
|
314
|
-
|state |The same string passed when redirecting to the webview |
|
315
|
-
|error |In case of error, the value will be **access_denied**, meaning the user has canceled the process |
|
316
|
-
|
317
|
-
Eventually, to get the **access_token** from the temporarily code which has been transmitted to you, you must call the API:
|
318
|
-
|
319
|
-
```python
|
320
|
-
try:
|
321
|
-
if client.handleCallback(received_params):
|
322
|
-
# Keep the token associated with the user
|
323
|
-
# you can't get it twice
|
324
|
-
user.session['access_token'] = client.access_token
|
325
|
-
except client.StateInvalid:
|
326
|
-
# error if 'state' param provided to handleCallback doesn't match
|
327
|
-
except client.AuthFailed:
|
328
|
-
# There may be an error in the query (look for the message),
|
329
|
-
# Or return code is 'access_denied', the user has stopped the process
|
330
|
-
```
|
331
|
-
|
332
|
-
You can now associate this **access_token** to your user, and use it in your next calls to the API with
|
333
|
-
the **Authorization** header. **IMPORTANT** It is important that your users are able to go back on the web,
|
334
|
-
authenticated on their Budgea API account, to add or remove accounts shared with you, and mostly to update their
|
335
|
-
credentials if needed. To do this, when your user is given an access_token, you have to provide him a link to access
|
336
|
-
the webview, similar to the first one, with an additional parameter: a temporarily token (30 minutes life-time).
|
337
|
-
|
338
|
-
It can be made with the library, by generating the URL with the following manner:
|
339
|
-
` print '<a href=\"%s\">Edit your accounts</a>' % client.get_settings_url()`
|
340
|
-
|
341
|
-
After the modification, the user will go back on the callback URL. It will not be necessary to do anything (the access_token won't be changed).
|
342
|
-
|
343
|
-
#### Protocol
|
344
|
-
|
345
|
-
This section describes the protocol used to set bank and provider accounts of a user, in case you don't want to use
|
346
|
-
the webview. The idea is to call the following services client-side (with AJAX in case of a web application),
|
347
|
-
to ensure the bank and providers credentials will not be sent to your servers. 1. /auth/init
|
348
|
-
|
349
|
-
```http
|
350
|
-
POST /auth/init
|
351
|
-
```
|
352
|
-
|
353
|
-
```json
|
354
|
-
{
|
355
|
-
"auth_token": "fBqjMZbYddebUGlkR445JKPA6pCoRaGb",
|
356
|
-
"type": "temporary",
|
357
|
-
"expires_in": 1800
|
358
|
-
}
|
359
|
-
```
|
360
|
-
This service creates a temporarily token, to use in the \"Authorization\" header in next calls to the API
|
361
|
-
The returned token has a life-time of 30 minutes, and should be transfered to the API then (cf Permanent Token),
|
362
|
-
so that your server can get a permanent access_token. It is possible to generate a permanent token immediately, by
|
363
|
-
calling the service with the manage_token, or by supply parameters client_id and client_secret. 2. /banks or /providers
|
364
|
-
```http
|
365
|
-
GET /banks?expand=fields Authorization: Bearer <token>
|
366
|
-
```
|
367
|
-
```json
|
368
|
-
{
|
369
|
-
"banks": [
|
370
|
-
{
|
371
|
-
"hidden": false,
|
372
|
-
"charged": true,
|
373
|
-
"name": "American Express",
|
374
|
-
"id": 30,
|
375
|
-
"fields": [
|
376
|
-
{
|
377
|
-
"values": [
|
378
|
-
{
|
379
|
-
"label": "Particuliers/Professionnels",
|
380
|
-
"value": "pp"
|
381
|
-
},
|
382
|
-
{
|
383
|
-
"value": "ent",
|
384
|
-
"label": "Entreprises"
|
385
|
-
}
|
386
|
-
],
|
387
|
-
"label": "Type de compte",
|
388
|
-
"regex": null,
|
389
|
-
"name": "website",
|
390
|
-
"type": "list"
|
391
|
-
},
|
392
|
-
{
|
393
|
-
"type": "password",
|
394
|
-
"label": "Code secret",
|
395
|
-
"name": "password",
|
396
|
-
"regex": "^[0-9]{6}$"
|
397
|
-
}
|
398
|
-
]
|
399
|
-
},
|
400
|
-
...
|
401
|
-
],
|
402
|
-
"total": 44
|
403
|
-
}
|
404
|
-
```
|
405
|
-
|
406
|
-
You get list of connectors, and all associated fields needed to build the form You can use that list to show your user
|
407
|
-
all available banks. 3. /users/me/connections You have to supply the id_bank (ID of the chosen bank) or
|
408
|
-
id_provider (ID of provider), and all requested fields as key/value parameters. You can get the following return codes:
|
409
|
-
|
410
|
-
|Code |Description |
|
411
|
-
|---------------|------------------------------------------------------------ |
|
412
|
-
|200 |The connection has succeed and has been created |
|
413
|
-
|202 |It is necessary to provide complementary information. This occurs on the first connection on some kind of Boursorama accounts for example, where a SMS is sent to the customer. It is necessary to ask the user to fill fields requested in the fields, and do a POST again on /users/me/connections/ID, with the connection ID in id_connection. |
|
414
|
-
|400 |Unable to connect to the website, the field error in the JSON can be **websiteUnavailable** or **wrongpass** |
|
415
|
-
|403 |Invalid token |
|
416
|
-
|
417
|
-
4. Permanent token If the user validates the share of accounts with you, it is necessary to transform the temporarily
|
418
|
-
code to a permanent access_token. To do that, you have to supply it to your server, which should do a POST
|
419
|
-
request on `/auth/token/access` with the following parameters:
|
420
|
-
|
421
|
-
|Parameter |Description |
|
422
|
-
|---------------------|----------------------------------------------------------------|
|
423
|
-
|code |The temporarily token which will let you get the access_token |
|
424
|
-
|client_id |The ID of your client application |
|
425
|
-
|client_secret |The secret of your client application |
|
426
|
-
|
427
|
-
```http
|
428
|
-
POST /auth/token/access
|
429
|
-
```
|
430
|
-
```json
|
431
|
-
{
|
432
|
-
"client_id": 17473055,
|
433
|
-
"client_secret": "54tHJHjvodbANVzaRtcLzlHGXQiOgw80",
|
434
|
-
"code": "fBqjMZbYddebUGlkR445JKPA6pCoRaGb"
|
435
|
-
}
|
436
|
-
```
|
437
|
-
|
438
|
-
```http
|
439
|
-
HTTP/1.1 200 OK
|
440
|
-
```
|
441
|
-
```json
|
442
|
-
{
|
443
|
-
"access_token": "7wBPuFfb1Hod82f1+KNa0AmrkIuQ3h1G",
|
444
|
-
"token_type":"Bearer"
|
445
|
-
}
|
446
|
-
```
|
447
|
-
|
448
|
-
### Update accounts
|
449
|
-
|
450
|
-
Another important call is when a user wants to add/remove connections to banks or providers, or to change the password
|
451
|
-
on one of them, it is advised to give him a temporarily code from the permanent access_token, with the following call
|
452
|
-
(using the access_token as bearer):
|
453
|
-
|
454
|
-
```http POST /auth/token/code Authorization: Bearer <token> ```
|
455
|
-
|
456
|
-
```json
|
457
|
-
{
|
458
|
-
"code": "/JiDppWgbmc+5ztHIUJtHl0ynYfw682Z",
|
459
|
-
"type": "temporary",
|
460
|
-
"expires_in": 1800
|
461
|
-
}
|
462
|
-
```
|
463
|
-
|
464
|
-
Its life-time is 30 minutes, and let the browser to list connections and accounts,
|
465
|
-
via `GET /users/me/connections?expand=accounts` for example.
|
466
|
-
|
467
|
-
To update the password of a connection, you can do a POST on the *connection* resource, with the field *password*
|
468
|
-
in the data. The new credentials are checked to make sure they are valid, and the return codes are the same as when
|
469
|
-
adding a connection. ## Getting the data You have created your users and their connections, now it's time to get the
|
470
|
-
data. There are 2 ways to retrieve it, the 2 can be complementary: - make regular calls to the API - use the webhooks
|
471
|
-
(recommended)
|
472
|
-
|
473
|
-
### Manual Synchronization
|
474
|
-
It is possible to do a manual synchronization of a user. We recommend to use this method in case the user wants fresh data after logging in.
|
475
|
-
To trigger the synchronization, call the API as below: `PUT /users/ID/connections` The following call is blocking until the synchronization is terminated.
|
476
|
-
Even if it is not recommended, it's possible to fetch synchronously new data. To do that, you can use the *expand* parameter:
|
477
|
-
` /users/ID/connections?expand=accounts[transactions,investments[type]],subscriptions`
|
478
|
-
|
479
|
-
```json
|
480
|
-
{
|
481
|
-
"connections": [
|
482
|
-
{
|
483
|
-
"accounts": [
|
484
|
-
{
|
485
|
-
"balance": 7481.01,
|
486
|
-
"currency": {
|
487
|
-
"symbol": "€",
|
488
|
-
"id": "EUR",
|
489
|
-
"prefix": false
|
490
|
-
},
|
491
|
-
"deleted": null,
|
492
|
-
"display": true,
|
493
|
-
"formatted_balance": "7 481,01 €",
|
494
|
-
"iban": "FR76131048379405300290000016",
|
495
|
-
"id": 17,
|
496
|
-
"id_connection": 7,
|
497
|
-
"investments": [
|
498
|
-
{
|
499
|
-
"code": "FR0010330902",
|
500
|
-
"description": "",
|
501
|
-
"diff": -67.86,
|
502
|
-
"id": 55,
|
503
|
-
"id_account": 19,
|
504
|
-
"id_type": 1,
|
505
|
-
"label": "Agressor PEA",
|
506
|
-
"portfolio_share": 0.48,
|
507
|
-
"prev_diff": 2019.57,
|
508
|
-
"quantity": 7.338,
|
509
|
-
"type": {
|
510
|
-
"color": "AABBCC",
|
511
|
-
"id": 1,
|
512
|
-
"name": "Fonds action"
|
513
|
-
},
|
514
|
-
"unitprice": 488.98,
|
515
|
-
"unitvalue": 479.73,
|
516
|
-
"valuation": 3520.28
|
517
|
-
}
|
518
|
-
],
|
519
|
-
"last_update": "2015-07-04 15:17:30",
|
520
|
-
"name": "Compte chèque",
|
521
|
-
"number": "3002900000",
|
522
|
-
"transactions": [
|
523
|
-
{
|
524
|
-
"active": true,
|
525
|
-
"application_date": "2015-06-17",
|
526
|
-
"coming": false,
|
527
|
-
"comment": null,
|
528
|
-
"commission": null,
|
529
|
-
"country": null,
|
530
|
-
"date": "2015-06-18",
|
531
|
-
"date_scraped": "2015-07-04 15:17:30",
|
532
|
-
"deleted": null,
|
533
|
-
"documents_count": 0,
|
534
|
-
"formatted_value": "-16,22 €",
|
535
|
-
"id": 309,
|
536
|
-
"id_account": 17,
|
537
|
-
"id_category": 9998,
|
538
|
-
"id_cluster": null,
|
539
|
-
"last_update": "2015-07-04 15:17:30",
|
540
|
-
"new": true,
|
541
|
-
"original_currency": null,
|
542
|
-
"original_value": null,
|
543
|
-
"original_wording": "FACTURE CB HALL'S BEER",
|
544
|
-
"rdate": "2015-06-17",
|
545
|
-
"simplified_wording": "HALL'S BEER",
|
546
|
-
"state": "parsed",
|
547
|
-
"stemmed_wording": "HALL'S BEER",
|
548
|
-
"type": "card",
|
549
|
-
"value": -16.22,
|
550
|
-
"wording": "HALL'S BEER"
|
551
|
-
}
|
552
|
-
],
|
553
|
-
"type": "checking"
|
554
|
-
}
|
555
|
-
],
|
556
|
-
"error": null,
|
557
|
-
"expire": null,
|
558
|
-
"id": 7,
|
559
|
-
"id_user": 7,
|
560
|
-
"id_bank": 41,
|
561
|
-
"last_update": "2015-07-04 15:17:31"
|
562
|
-
}
|
563
|
-
],
|
564
|
-
"total": 1
|
565
|
-
}
|
566
|
-
```
|
567
|
-
|
568
|
-
### Background synchronizations & Webhooks
|
569
|
-
|
570
|
-
Webhooks are callbacks sent to your server, when an event is triggered during a synchronization.
|
571
|
-
Synchronizations are automatic, the frequency can be set using the configuration key `autosync.frequency`.
|
572
|
-
Using webhooks allows you to get the most up-to-date data of your users, after each synchronization.
|
573
|
-
The automatic synchronization makes it possible to recover new bank entries, or new invoices, at a given frequency.
|
574
|
-
You have the possibility to add webhooks on several events, and choose to receive each one on a distinct URL.
|
575
|
-
To see the list of available webhooks you can call the endpoint hereunder:
|
576
|
-
|
577
|
-
```
|
578
|
-
curl -X GET \
|
579
|
-
https://demo.biapi.pro/2.0/webhooks_events \
|
580
|
-
-H 'Authorization: Bearer <token>'
|
581
|
-
```
|
582
|
-
|
583
|
-
The background synchronizations for each user are independent, and their plannings are spread over the day so that they do not overload any website. Once the synchronization of a user is over, a POST request is sent on the callback URL you have defined, including all webhook data. A typical json sent to your server is as below:
|
584
|
-
|
585
|
-
```http
|
586
|
-
POST /callback HTTP/1.1 Host: example.org
|
587
|
-
Content-Length: 959 Accept-Encoding: gzip, deflate, compress
|
588
|
-
Accept: */* User-Agent: Budgea API/2.0
|
589
|
-
Content-Type: application/json; charset=utf-8
|
590
|
-
Authorization: Bearer sl/wuqgD2eOo+4Zf9FjvAz3YJgU+JKsJ
|
591
|
-
```
|
592
|
-
```json
|
593
|
-
{
|
594
|
-
"connections": [
|
595
|
-
{
|
596
|
-
"accounts": [
|
597
|
-
{
|
598
|
-
"balance": 7481.01,
|
599
|
-
"currency": {
|
600
|
-
"symbol": "€",
|
601
|
-
"id": "EUR",
|
602
|
-
"prefix": false
|
603
|
-
},
|
604
|
-
"deleted": null,
|
605
|
-
"display": true,
|
606
|
-
"formatted_balance": "7 481,01 €",
|
607
|
-
"iban": "FR76131048379405300290000016",
|
608
|
-
"id": 17,
|
609
|
-
"id_connection": 7,
|
610
|
-
"investments": [
|
611
|
-
{
|
612
|
-
"code": "FR0010330902",
|
613
|
-
"description": "",
|
614
|
-
"diff": -67.86,
|
615
|
-
"id": 55,
|
616
|
-
"id_account": 19,
|
617
|
-
"id_type": 1,
|
618
|
-
"label": "Agressor PEA",
|
619
|
-
"portfolio_share": 0.48,
|
620
|
-
"prev_diff": 2019.57,
|
621
|
-
"quantity": 7.338,
|
622
|
-
"type": {
|
623
|
-
"color": "AABBCC",
|
624
|
-
"id": 1,
|
625
|
-
"name": "Fonds action"
|
626
|
-
},
|
627
|
-
"unitprice": 488.98,
|
628
|
-
"unitvalue": 479.73,
|
629
|
-
"valuation": 3520.28
|
630
|
-
}
|
631
|
-
],
|
632
|
-
"last_update": "2015-07-04 15:17:30",
|
633
|
-
"name": "Compte chèque",
|
634
|
-
"number": "3002900000",
|
635
|
-
"transactions": [
|
636
|
-
{
|
637
|
-
"active": true,
|
638
|
-
"application_date": "2015-06-17",
|
639
|
-
"coming": false,
|
640
|
-
"comment": null,
|
641
|
-
"commission": null,
|
642
|
-
"country": null,
|
643
|
-
"date": "2015-06-18",
|
644
|
-
"date_scraped": "2015-07-04 15:17:30",
|
645
|
-
"deleted": null,
|
646
|
-
"documents_count": 0,
|
647
|
-
"formatted_value": "-16,22 €",
|
648
|
-
"id": 309,
|
649
|
-
"id_account": 17,
|
650
|
-
"id_category": 9998,
|
651
|
-
"id_cluster": null,
|
652
|
-
"last_update": "2015-07-04 15:17:30",
|
653
|
-
"new": true,
|
654
|
-
"original_currency": null,
|
655
|
-
"original_value": null,
|
656
|
-
"original_wording": "FACTURE CB HALL'S BEER",
|
657
|
-
"rdate": "2015-06-17",
|
658
|
-
"simplified_wording": "HALL'S BEER",
|
659
|
-
"state": "parsed",
|
660
|
-
"stemmed_wording": "HALL'S BEER",
|
661
|
-
"type": "card",
|
662
|
-
"value": -16.22,
|
663
|
-
"wording": "HALL'S BEER"
|
664
|
-
}
|
665
|
-
],
|
666
|
-
"type": "checking"
|
667
|
-
}
|
668
|
-
],
|
669
|
-
"bank": {
|
670
|
-
"id_weboob": "ing",
|
671
|
-
"charged": true,
|
672
|
-
"name": "ING Direct",
|
673
|
-
"id": 7,
|
674
|
-
"hidden": false
|
675
|
-
},
|
676
|
-
"error": null,
|
677
|
-
"expire": null,
|
678
|
-
"id": 7,
|
679
|
-
"id_user": 7,
|
680
|
-
"id_bank": 41,
|
681
|
-
"last_update": "2015-07-04 15:17:31"
|
682
|
-
}
|
683
|
-
],
|
684
|
-
"total": 1,
|
685
|
-
"user": {
|
686
|
-
"signin": "2015-07-04 15:17:29",
|
687
|
-
"id": 7,
|
688
|
-
"platform": "sharedAccess"
|
689
|
-
}
|
690
|
-
}
|
691
|
-
```
|
692
|
-
|
693
|
-
The authentication on the callback is made with the access_token of the user (which is a shared secret between your server and the Budgea API). When you are in production, it is needed to define a HTTPS URL using a valid certificate, delivered by a recognized authority. If this is not the case, you can contact us to add your CA (Certificate Authority) to our PKI (Public Key Infrastructure). Important: it is necessary to send back a HTTP 200 code, without what we consider that data is not correctly taken into account on your system, and it will be sent again at the next user synchronization. ## Guidelines for production Now you should have integrated the API inside your application. Make sure your Webhooks URLs are in HTTPS, if so you can enable the production state of the API. To make things great, here are some good practices, please check you have respected them: - You have provided to your users a way to configure their accounts - You have provided to your users a way to change their account passwords - You consider the **error** field of Connections, to alert the user in case the state is **wrongpass** - You map IDs of Accounts, Subscriptions, Transactions and Documents in your application, to be sure to correctly match them - When the deleted field is set on a bank transaction, you delete it in your database - You don't loop on all users to launch synchronizations, this might saturate the service If you have questions about above points, please contact us. Otherwise, you can put into production!
|
5
|
+
No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
|
694
6
|
|
695
7
|
This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
|
696
8
|
|
@@ -753,7 +65,7 @@ end
|
|
753
65
|
api_instance = BudgeaClient::AdministrationApi.new
|
754
66
|
|
755
67
|
opts = {
|
756
|
-
expand:
|
68
|
+
expand: 'expand_example' # String |
|
757
69
|
}
|
758
70
|
|
759
71
|
begin
|
@@ -781,52 +93,62 @@ Class | Method | HTTP request | Description
|
|
781
93
|
*BudgeaClient::AdministrationApi* | [**clients_post**](docs/AdministrationApi.md#clients_post) | **POST** /clients | Create a client
|
782
94
|
*BudgeaClient::AdministrationApi* | [**config_get**](docs/AdministrationApi.md#config_get) | **GET** /config | Get configuration of the API.
|
783
95
|
*BudgeaClient::AdministrationApi* | [**config_post**](docs/AdministrationApi.md#config_post) | **POST** /config | Set a configuration value on the API.
|
96
|
+
*BudgeaClient::AdministrationApi* | [**merchants_get**](docs/AdministrationApi.md#merchants_get) | **GET** /merchants | List clients
|
97
|
+
*BudgeaClient::AdministrationApi* | [**merchants_id_client_logo_delete**](docs/AdministrationApi.md#merchants_id_client_logo_delete) | **DELETE** /merchants/{id_client}/logo | Delete the client logo
|
98
|
+
*BudgeaClient::AdministrationApi* | [**merchants_id_client_logo_post**](docs/AdministrationApi.md#merchants_id_client_logo_post) | **POST** /merchants/{id_client}/logo | Update the client logo
|
99
|
+
*BudgeaClient::AdministrationApi* | [**merchants_post**](docs/AdministrationApi.md#merchants_post) | **POST** /merchants | Create a merchant. Needs a user identified in bearer to be used
|
784
100
|
*BudgeaClient::AdministrationApi* | [**monitoring_get**](docs/AdministrationApi.md#monitoring_get) | **GET** /monitoring | get performances stats on this instance
|
785
101
|
*BudgeaClient::AdministrationApi* | [**test_sync_post**](docs/AdministrationApi.md#test_sync_post) | **POST** /test/sync | Test synchronization on a random connection.
|
786
102
|
*BudgeaClient::AdministrationApi* | [**test_webhooks_post**](docs/AdministrationApi.md#test_webhooks_post) | **POST** /test/webhooks | Test synchronization on a random connection.
|
787
103
|
*BudgeaClient::AdministrationApi* | [**webhooks_delete**](docs/AdministrationApi.md#webhooks_delete) | **DELETE** /webhooks | Deletes all webhooks
|
788
104
|
*BudgeaClient::AdministrationApi* | [**webhooks_get**](docs/AdministrationApi.md#webhooks_get) | **GET** /webhooks | Get webhooks
|
789
105
|
*BudgeaClient::AdministrationApi* | [**webhooks_id_webhook_delete**](docs/AdministrationApi.md#webhooks_id_webhook_delete) | **DELETE** /webhooks/{id_webhook} | Deletes a webhook
|
106
|
+
*BudgeaClient::AdministrationApi* | [**webhooks_id_webhook_logs_get**](docs/AdministrationApi.md#webhooks_id_webhook_logs_get) | **GET** /webhooks/{id_webhook}/logs | Get webhooks logs.
|
790
107
|
*BudgeaClient::AdministrationApi* | [**webhooks_id_webhook_post**](docs/AdministrationApi.md#webhooks_id_webhook_post) | **POST** /webhooks/{id_webhook} | Updates a webhook
|
791
108
|
*BudgeaClient::AdministrationApi* | [**webhooks_id_webhook_put**](docs/AdministrationApi.md#webhooks_id_webhook_put) | **PUT** /webhooks/{id_webhook} | Updates a webhook
|
792
109
|
*BudgeaClient::AdministrationApi* | [**webhooks_post**](docs/AdministrationApi.md#webhooks_post) | **POST** /webhooks | Adds a new webhook
|
110
|
+
*BudgeaClient::AuthenticationApi* | [**admin_jwt_post**](docs/AuthenticationApi.md#admin_jwt_post) | **POST** /admin/jwt | Generate a jwt manage token
|
793
111
|
*BudgeaClient::AuthenticationApi* | [**auth_init_post**](docs/AuthenticationApi.md#auth_init_post) | **POST** /auth/init | Create a new anonymous user
|
112
|
+
*BudgeaClient::AuthenticationApi* | [**auth_jwt_post**](docs/AuthenticationApi.md#auth_jwt_post) | **POST** /auth/jwt | Generate a user jwt token
|
794
113
|
*BudgeaClient::AuthenticationApi* | [**auth_token_access_post**](docs/AuthenticationApi.md#auth_token_access_post) | **POST** /auth/token/access | Transform a temporary code to a access_token
|
795
114
|
*BudgeaClient::AuthenticationApi* | [**auth_token_code_get**](docs/AuthenticationApi.md#auth_token_code_get) | **GET** /auth/token/code | Generate a user temporary token
|
796
115
|
*BudgeaClient::AuthenticationApi* | [**auth_token_delete**](docs/AuthenticationApi.md#auth_token_delete) | **DELETE** /auth/token | Remove user access
|
116
|
+
*BudgeaClient::AuthenticationApi* | [**certificate_type_get**](docs/AuthenticationApi.md#certificate_type_get) | **GET** /certificate/{type} | Get the latest certificate of a type
|
797
117
|
*BudgeaClient::AuthenticationApi* | [**hash_delete**](docs/AuthenticationApi.md#hash_delete) | **DELETE** /hash | Delete the user's connections
|
798
118
|
*BudgeaClient::AuthenticationApi* | [**users_id_user_delete**](docs/AuthenticationApi.md#users_id_user_delete) | **DELETE** /users/{id_user} | Delete the user
|
799
119
|
*BudgeaClient::AuthenticationApi* | [**users_id_user_get**](docs/AuthenticationApi.md#users_id_user_get) | **GET** /users/{id_user} | Get a user
|
800
120
|
*BudgeaClient::AuthenticationApi* | [**users_id_user_token_post**](docs/AuthenticationApi.md#users_id_user_token_post) | **POST** /users/{id_user}/token | Create a token
|
121
|
+
*BudgeaClient::AuthenticationApi* | [**webauth_get**](docs/AuthenticationApi.md#webauth_get) | **GET** /webauth | Initialize a new OAuth2 proxy session.
|
801
122
|
*BudgeaClient::BanksApi* | [**account_types_get**](docs/BanksApi.md#account_types_get) | **GET** /account_types | Get account types
|
802
123
|
*BudgeaClient::BanksApi* | [**account_types_id_account_type_get**](docs/BanksApi.md#account_types_id_account_type_get) | **GET** /account_types/{id_account_type} | Get an account type
|
803
124
|
*BudgeaClient::BanksApi* | [**banks_categories_id_category_delete**](docs/BanksApi.md#banks_categories_id_category_delete) | **DELETE** /banks/categories/{id_category} | Delete the supplied category
|
804
125
|
*BudgeaClient::BanksApi* | [**banks_categories_id_category_post**](docs/BanksApi.md#banks_categories_id_category_post) | **POST** /banks/categories/{id_category} | Edit a bank categories
|
805
126
|
*BudgeaClient::BanksApi* | [**banks_categories_post**](docs/BanksApi.md#banks_categories_post) | **POST** /banks/categories | Create bank categories
|
806
127
|
*BudgeaClient::BanksApi* | [**banks_get**](docs/BanksApi.md#banks_get) | **GET** /banks | Get list of connectors
|
807
|
-
*BudgeaClient::BanksApi* | [**
|
808
|
-
*BudgeaClient::BanksApi* | [**
|
809
|
-
*BudgeaClient::BanksApi* | [**
|
810
|
-
*BudgeaClient::BanksApi* | [**
|
128
|
+
*BudgeaClient::BanksApi* | [**banks_id_connector_connections_get**](docs/BanksApi.md#banks_id_connector_connections_get) | **GET** /banks/{id_connector}/connections | Get a subset of id_connection with the largest diversity of account
|
129
|
+
*BudgeaClient::BanksApi* | [**banks_id_connector_logos_get**](docs/BanksApi.md#banks_id_connector_logos_get) | **GET** /banks/{id_connector}/logos | Get all links to the files associated with this connector.
|
130
|
+
*BudgeaClient::BanksApi* | [**banks_id_connector_logos_main_get**](docs/BanksApi.md#banks_id_connector_logos_main_get) | **GET** /banks/{id_connector}/logos/main | Get all links to the files associated with this connector.
|
131
|
+
*BudgeaClient::BanksApi* | [**banks_id_connector_logos_thumbnail_get**](docs/BanksApi.md#banks_id_connector_logos_thumbnail_get) | **GET** /banks/{id_connector}/logos/thumbnail | Get all links to the files associated with this connector.
|
811
132
|
*BudgeaClient::BanksApi* | [**categories_get**](docs/BanksApi.md#categories_get) | **GET** /categories | Get all categories
|
812
133
|
*BudgeaClient::BanksApi* | [**categorize_post**](docs/BanksApi.md#categorize_post) | **POST** /categorize | categorize transactions without storing them
|
813
134
|
*BudgeaClient::BanksApi* | [**connections_get**](docs/BanksApi.md#connections_get) | **GET** /connections | Get connections without a user
|
814
135
|
*BudgeaClient::BanksApi* | [**connectors_get**](docs/BanksApi.md#connectors_get) | **GET** /connectors | Get list of connectors
|
815
|
-
*BudgeaClient::BanksApi* | [**
|
816
|
-
*BudgeaClient::BanksApi* | [**
|
817
|
-
*BudgeaClient::BanksApi* | [**
|
818
|
-
*BudgeaClient::BanksApi* | [**
|
819
|
-
*BudgeaClient::BanksApi* | [**
|
820
|
-
*BudgeaClient::BanksApi* | [**
|
821
|
-
*BudgeaClient::BanksApi* | [**
|
822
|
-
*BudgeaClient::BanksApi* | [**connectors_id_connector_put**](docs/BanksApi.md#connectors_id_connector_put) | **PUT** /connectors/{id_connector} | Edit the provided
|
136
|
+
*BudgeaClient::BanksApi* | [**connectors_id_connector_logos_get**](docs/BanksApi.md#connectors_id_connector_logos_get) | **GET** /connectors/{id_connector}/logos | Get all links to the files associated with this connector.
|
137
|
+
*BudgeaClient::BanksApi* | [**connectors_id_connector_logos_id_logo_delete**](docs/BanksApi.md#connectors_id_connector_logos_id_logo_delete) | **DELETE** /connectors/{id_connector}/logos/{id_logo} | Delete a single Logo object.
|
138
|
+
*BudgeaClient::BanksApi* | [**connectors_id_connector_logos_id_logo_put**](docs/BanksApi.md#connectors_id_connector_logos_id_logo_put) | **PUT** /connectors/{id_connector}/logos/{id_logo} | Create or Update a connector Logo.
|
139
|
+
*BudgeaClient::BanksApi* | [**connectors_id_connector_logos_main_get**](docs/BanksApi.md#connectors_id_connector_logos_main_get) | **GET** /connectors/{id_connector}/logos/main | Get all links to the files associated with this connector.
|
140
|
+
*BudgeaClient::BanksApi* | [**connectors_id_connector_logos_post**](docs/BanksApi.md#connectors_id_connector_logos_post) | **POST** /connectors/{id_connector}/logos | Create a connector Logo
|
141
|
+
*BudgeaClient::BanksApi* | [**connectors_id_connector_logos_put**](docs/BanksApi.md#connectors_id_connector_logos_put) | **PUT** /connectors/{id_connector}/logos | Create or Update a connector Logo
|
142
|
+
*BudgeaClient::BanksApi* | [**connectors_id_connector_logos_thumbnail_get**](docs/BanksApi.md#connectors_id_connector_logos_thumbnail_get) | **GET** /connectors/{id_connector}/logos/thumbnail | Get all links to the files associated with this connector.
|
143
|
+
*BudgeaClient::BanksApi* | [**connectors_id_connector_put**](docs/BanksApi.md#connectors_id_connector_put) | **PUT** /connectors/{id_connector} | Edit the provided connector
|
823
144
|
*BudgeaClient::BanksApi* | [**connectors_post**](docs/BanksApi.md#connectors_post) | **POST** /connectors | Request a new connector
|
824
145
|
*BudgeaClient::BanksApi* | [**invoicing_get**](docs/BanksApi.md#invoicing_get) | **GET** /invoicing | Get number of accounts, connections and users synced.
|
825
146
|
*BudgeaClient::BanksApi* | [**logs_get**](docs/BanksApi.md#logs_get) | **GET** /logs | Get connection logs
|
826
147
|
*BudgeaClient::BanksApi* | [**providers_get**](docs/BanksApi.md#providers_get) | **GET** /providers | Get list of connectors
|
827
|
-
*BudgeaClient::BanksApi* | [**
|
828
|
-
*BudgeaClient::BanksApi* | [**
|
829
|
-
*BudgeaClient::BanksApi* | [**
|
148
|
+
*BudgeaClient::BanksApi* | [**providers_id_connector_connections_get**](docs/BanksApi.md#providers_id_connector_connections_get) | **GET** /providers/{id_connector}/connections | Get a random subset of provider's id_connection
|
149
|
+
*BudgeaClient::BanksApi* | [**providers_id_connector_logos_get**](docs/BanksApi.md#providers_id_connector_logos_get) | **GET** /providers/{id_connector}/logos | Get all links to the files associated with this connector.
|
150
|
+
*BudgeaClient::BanksApi* | [**providers_id_connector_logos_main_get**](docs/BanksApi.md#providers_id_connector_logos_main_get) | **GET** /providers/{id_connector}/logos/main | Get all links to the files associated with this connector.
|
151
|
+
*BudgeaClient::BanksApi* | [**providers_id_connector_logos_thumbnail_get**](docs/BanksApi.md#providers_id_connector_logos_thumbnail_get) | **GET** /providers/{id_connector}/logos/thumbnail | Get all links to the files associated with this connector.
|
830
152
|
*BudgeaClient::BanksApi* | [**users_id_user_account_types_get**](docs/BanksApi.md#users_id_user_account_types_get) | **GET** /users/{id_user}/account_types | Get account types
|
831
153
|
*BudgeaClient::BanksApi* | [**users_id_user_account_types_id_account_type_get**](docs/BanksApi.md#users_id_user_account_types_id_account_type_get) | **GET** /users/{id_user}/account_types/{id_account_type} | Get an account type
|
832
154
|
*BudgeaClient::BanksApi* | [**users_id_user_accounts_delete**](docs/BanksApi.md#users_id_user_accounts_delete) | **DELETE** /users/{id_user}/accounts | Delete all accounts
|
@@ -850,8 +172,12 @@ Class | Method | HTTP request | Description
|
|
850
172
|
*BudgeaClient::BanksApi* | [**users_id_user_accounts_id_account_transactionsclusters_id_transactionscluster_put**](docs/BanksApi.md#users_id_user_accounts_id_account_transactionsclusters_id_transactionscluster_put) | **PUT** /users/{id_user}/accounts/{id_account}/transactionsclusters/{id_transactionscluster} | Edit a clustered transaction
|
851
173
|
*BudgeaClient::BanksApi* | [**users_id_user_accounts_id_account_transactionsclusters_post**](docs/BanksApi.md#users_id_user_accounts_id_account_transactionsclusters_post) | **POST** /users/{id_user}/accounts/{id_account}/transactionsclusters | Create clustered transaction
|
852
174
|
*BudgeaClient::BanksApi* | [**users_id_user_accounts_post**](docs/BanksApi.md#users_id_user_accounts_post) | **POST** /users/{id_user}/accounts | Create an account
|
175
|
+
*BudgeaClient::BanksApi* | [**users_id_user_accounts_put**](docs/BanksApi.md#users_id_user_accounts_put) | **PUT** /users/{id_user}/accounts | Update many accounts at once
|
853
176
|
*BudgeaClient::BanksApi* | [**users_id_user_alerts_get**](docs/BanksApi.md#users_id_user_alerts_get) | **GET** /users/{id_user}/alerts | Get alerts
|
854
177
|
*BudgeaClient::BanksApi* | [**users_id_user_categories_full_get**](docs/BanksApi.md#users_id_user_categories_full_get) | **GET** /users/{id_user}/categories/full | Get the category
|
178
|
+
*BudgeaClient::BanksApi* | [**users_id_user_categories_full_id_full_delete**](docs/BanksApi.md#users_id_user_categories_full_id_full_delete) | **DELETE** /users/{id_user}/categories/full/{id_full} | Delete a user-created transaction category
|
179
|
+
*BudgeaClient::BanksApi* | [**users_id_user_categories_full_id_full_put**](docs/BanksApi.md#users_id_user_categories_full_id_full_put) | **PUT** /users/{id_user}/categories/full/{id_full} | Modify a user-created category
|
180
|
+
*BudgeaClient::BanksApi* | [**users_id_user_categories_full_post**](docs/BanksApi.md#users_id_user_categories_full_post) | **POST** /users/{id_user}/categories/full | Create a new transaction category
|
855
181
|
*BudgeaClient::BanksApi* | [**users_id_user_categories_get**](docs/BanksApi.md#users_id_user_categories_get) | **GET** /users/{id_user}/categories | Get the category
|
856
182
|
*BudgeaClient::BanksApi* | [**users_id_user_connections_delete**](docs/BanksApi.md#users_id_user_connections_delete) | **DELETE** /users/{id_user}/connections | Delete all connections
|
857
183
|
*BudgeaClient::BanksApi* | [**users_id_user_connections_get**](docs/BanksApi.md#users_id_user_connections_get) | **GET** /users/{id_user}/connections | Get connections
|
@@ -876,6 +202,7 @@ Class | Method | HTTP request | Description
|
|
876
202
|
*BudgeaClient::BanksApi* | [**users_id_user_connections_id_connection_accounts_id_account_transactionsclusters_id_transactionscluster_put**](docs/BanksApi.md#users_id_user_connections_id_connection_accounts_id_account_transactionsclusters_id_transactionscluster_put) | **PUT** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/transactionsclusters/{id_transactionscluster} | Edit a clustered transaction
|
877
203
|
*BudgeaClient::BanksApi* | [**users_id_user_connections_id_connection_accounts_id_account_transactionsclusters_post**](docs/BanksApi.md#users_id_user_connections_id_connection_accounts_id_account_transactionsclusters_post) | **POST** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/transactionsclusters | Create clustered transaction
|
878
204
|
*BudgeaClient::BanksApi* | [**users_id_user_connections_id_connection_accounts_post**](docs/BanksApi.md#users_id_user_connections_id_connection_accounts_post) | **POST** /users/{id_user}/connections/{id_connection}/accounts | Create an account
|
205
|
+
*BudgeaClient::BanksApi* | [**users_id_user_connections_id_connection_accounts_put**](docs/BanksApi.md#users_id_user_connections_id_connection_accounts_put) | **PUT** /users/{id_user}/connections/{id_connection}/accounts | Update many accounts at once
|
879
206
|
*BudgeaClient::BanksApi* | [**users_id_user_connections_id_connection_delete**](docs/BanksApi.md#users_id_user_connections_id_connection_delete) | **DELETE** /users/{id_user}/connections/{id_connection} | Delete a connection.
|
880
207
|
*BudgeaClient::BanksApi* | [**users_id_user_connections_id_connection_informations_get**](docs/BanksApi.md#users_id_user_connections_id_connection_informations_get) | **GET** /users/{id_user}/connections/{id_connection}/informations | Get connection additionnal informations
|
881
208
|
*BudgeaClient::BanksApi* | [**users_id_user_connections_id_connection_logs_get**](docs/BanksApi.md#users_id_user_connections_id_connection_logs_get) | **GET** /users/{id_user}/connections/{id_connection}/logs | Get connection logs
|
@@ -911,12 +238,13 @@ Class | Method | HTTP request | Description
|
|
911
238
|
*BudgeaClient::BanksApi* | [**users_id_user_transactionsclusters_id_transactionscluster_put**](docs/BanksApi.md#users_id_user_transactionsclusters_id_transactionscluster_put) | **PUT** /users/{id_user}/transactionsclusters/{id_transactionscluster} | Edit a clustered transaction
|
912
239
|
*BudgeaClient::BanksApi* | [**users_id_user_transactionsclusters_post**](docs/BanksApi.md#users_id_user_transactionsclusters_post) | **POST** /users/{id_user}/transactionsclusters | Create clustered transaction
|
913
240
|
*BudgeaClient::ConnectionsApi* | [**banks_get**](docs/ConnectionsApi.md#banks_get) | **GET** /banks | Get list of connectors
|
914
|
-
*BudgeaClient::ConnectionsApi* | [**
|
241
|
+
*BudgeaClient::ConnectionsApi* | [**banks_id_connector_connections_get**](docs/ConnectionsApi.md#banks_id_connector_connections_get) | **GET** /banks/{id_connector}/connections | Get a subset of id_connection with the largest diversity of account
|
915
242
|
*BudgeaClient::ConnectionsApi* | [**connections_get**](docs/ConnectionsApi.md#connections_get) | **GET** /connections | Get connections without a user
|
916
243
|
*BudgeaClient::ConnectionsApi* | [**connectors_get**](docs/ConnectionsApi.md#connectors_get) | **GET** /connectors | Get list of connectors
|
917
244
|
*BudgeaClient::ConnectionsApi* | [**connectors_post**](docs/ConnectionsApi.md#connectors_post) | **POST** /connectors | Request a new connector
|
918
245
|
*BudgeaClient::ConnectionsApi* | [**logs_get**](docs/ConnectionsApi.md#logs_get) | **GET** /logs | Get connection logs
|
919
246
|
*BudgeaClient::ConnectionsApi* | [**providers_get**](docs/ConnectionsApi.md#providers_get) | **GET** /providers | Get list of connectors
|
247
|
+
*BudgeaClient::ConnectionsApi* | [**providers_id_connector_connections_get**](docs/ConnectionsApi.md#providers_id_connector_connections_get) | **GET** /providers/{id_connector}/connections | Get a random subset of provider's id_connection
|
920
248
|
*BudgeaClient::ConnectionsApi* | [**users_id_user_connections_delete**](docs/ConnectionsApi.md#users_id_user_connections_delete) | **DELETE** /users/{id_user}/connections | Delete all connections
|
921
249
|
*BudgeaClient::ConnectionsApi* | [**users_id_user_connections_get**](docs/ConnectionsApi.md#users_id_user_connections_get) | **GET** /users/{id_user}/connections | Get connections
|
922
250
|
*BudgeaClient::ConnectionsApi* | [**users_id_user_connections_id_connection_delete**](docs/ConnectionsApi.md#users_id_user_connections_id_connection_delete) | **DELETE** /users/{id_user}/connections/{id_connection} | Delete a connection.
|
@@ -1047,27 +375,27 @@ Class | Method | HTTP request | Description
|
|
1047
375
|
*BudgeaClient::PFMApi* | [**users_id_user_resume_get**](docs/PFMApi.md#users_id_user_resume_get) | **GET** /users/{id_user}/resume | Get synthesis configuration of a specific user
|
1048
376
|
*BudgeaClient::PFMApi* | [**users_id_user_resume_post**](docs/PFMApi.md#users_id_user_resume_post) | **POST** /users/{id_user}/resume | Update synthesis configuration
|
1049
377
|
*BudgeaClient::ProvidersApi* | [**banks_get**](docs/ProvidersApi.md#banks_get) | **GET** /banks | Get list of connectors
|
1050
|
-
*BudgeaClient::ProvidersApi* | [**
|
1051
|
-
*BudgeaClient::ProvidersApi* | [**
|
1052
|
-
*BudgeaClient::ProvidersApi* | [**
|
378
|
+
*BudgeaClient::ProvidersApi* | [**banks_id_connector_logos_get**](docs/ProvidersApi.md#banks_id_connector_logos_get) | **GET** /banks/{id_connector}/logos | Get all links to the files associated with this connector.
|
379
|
+
*BudgeaClient::ProvidersApi* | [**banks_id_connector_logos_main_get**](docs/ProvidersApi.md#banks_id_connector_logos_main_get) | **GET** /banks/{id_connector}/logos/main | Get all links to the files associated with this connector.
|
380
|
+
*BudgeaClient::ProvidersApi* | [**banks_id_connector_logos_thumbnail_get**](docs/ProvidersApi.md#banks_id_connector_logos_thumbnail_get) | **GET** /banks/{id_connector}/logos/thumbnail | Get all links to the files associated with this connector.
|
1053
381
|
*BudgeaClient::ProvidersApi* | [**connections_get**](docs/ProvidersApi.md#connections_get) | **GET** /connections | Get connections without a user
|
1054
382
|
*BudgeaClient::ProvidersApi* | [**connectors_get**](docs/ProvidersApi.md#connectors_get) | **GET** /connectors | Get list of connectors
|
1055
|
-
*BudgeaClient::ProvidersApi* | [**
|
1056
|
-
*BudgeaClient::ProvidersApi* | [**
|
1057
|
-
*BudgeaClient::ProvidersApi* | [**
|
1058
|
-
*BudgeaClient::ProvidersApi* | [**
|
1059
|
-
*BudgeaClient::ProvidersApi* | [**
|
1060
|
-
*BudgeaClient::ProvidersApi* | [**
|
1061
|
-
*BudgeaClient::ProvidersApi* | [**
|
383
|
+
*BudgeaClient::ProvidersApi* | [**connectors_id_connector_logos_get**](docs/ProvidersApi.md#connectors_id_connector_logos_get) | **GET** /connectors/{id_connector}/logos | Get all links to the files associated with this connector.
|
384
|
+
*BudgeaClient::ProvidersApi* | [**connectors_id_connector_logos_id_logo_delete**](docs/ProvidersApi.md#connectors_id_connector_logos_id_logo_delete) | **DELETE** /connectors/{id_connector}/logos/{id_logo} | Delete a single Logo object.
|
385
|
+
*BudgeaClient::ProvidersApi* | [**connectors_id_connector_logos_id_logo_put**](docs/ProvidersApi.md#connectors_id_connector_logos_id_logo_put) | **PUT** /connectors/{id_connector}/logos/{id_logo} | Create or Update a connector Logo.
|
386
|
+
*BudgeaClient::ProvidersApi* | [**connectors_id_connector_logos_main_get**](docs/ProvidersApi.md#connectors_id_connector_logos_main_get) | **GET** /connectors/{id_connector}/logos/main | Get all links to the files associated with this connector.
|
387
|
+
*BudgeaClient::ProvidersApi* | [**connectors_id_connector_logos_post**](docs/ProvidersApi.md#connectors_id_connector_logos_post) | **POST** /connectors/{id_connector}/logos | Create a connector Logo
|
388
|
+
*BudgeaClient::ProvidersApi* | [**connectors_id_connector_logos_put**](docs/ProvidersApi.md#connectors_id_connector_logos_put) | **PUT** /connectors/{id_connector}/logos | Create or Update a connector Logo
|
389
|
+
*BudgeaClient::ProvidersApi* | [**connectors_id_connector_logos_thumbnail_get**](docs/ProvidersApi.md#connectors_id_connector_logos_thumbnail_get) | **GET** /connectors/{id_connector}/logos/thumbnail | Get all links to the files associated with this connector.
|
1062
390
|
*BudgeaClient::ProvidersApi* | [**connectors_post**](docs/ProvidersApi.md#connectors_post) | **POST** /connectors | Request a new connector
|
1063
391
|
*BudgeaClient::ProvidersApi* | [**documenttypes_get**](docs/ProvidersApi.md#documenttypes_get) | **GET** /documenttypes | Get document types
|
1064
392
|
*BudgeaClient::ProvidersApi* | [**documenttypes_id_documenttype_put**](docs/ProvidersApi.md#documenttypes_id_documenttype_put) | **PUT** /documenttypes/{id_documenttype} | Edit a document type
|
1065
393
|
*BudgeaClient::ProvidersApi* | [**logs_get**](docs/ProvidersApi.md#logs_get) | **GET** /logs | Get connection logs
|
1066
394
|
*BudgeaClient::ProvidersApi* | [**ocr_post**](docs/ProvidersApi.md#ocr_post) | **POST** /ocr | Post an image with OCR
|
1067
395
|
*BudgeaClient::ProvidersApi* | [**providers_get**](docs/ProvidersApi.md#providers_get) | **GET** /providers | Get list of connectors
|
1068
|
-
*BudgeaClient::ProvidersApi* | [**
|
1069
|
-
*BudgeaClient::ProvidersApi* | [**
|
1070
|
-
*BudgeaClient::ProvidersApi* | [**
|
396
|
+
*BudgeaClient::ProvidersApi* | [**providers_id_connector_logos_get**](docs/ProvidersApi.md#providers_id_connector_logos_get) | **GET** /providers/{id_connector}/logos | Get all links to the files associated with this connector.
|
397
|
+
*BudgeaClient::ProvidersApi* | [**providers_id_connector_logos_main_get**](docs/ProvidersApi.md#providers_id_connector_logos_main_get) | **GET** /providers/{id_connector}/logos/main | Get all links to the files associated with this connector.
|
398
|
+
*BudgeaClient::ProvidersApi* | [**providers_id_connector_logos_thumbnail_get**](docs/ProvidersApi.md#providers_id_connector_logos_thumbnail_get) | **GET** /providers/{id_connector}/logos/thumbnail | Get all links to the files associated with this connector.
|
1071
399
|
*BudgeaClient::ProvidersApi* | [**users_id_user_accounts_id_account_transactions_id_transaction_documents_delete**](docs/ProvidersApi.md#users_id_user_accounts_id_account_transactions_id_transaction_documents_delete) | **DELETE** /users/{id_user}/accounts/{id_account}/transactions/{id_transaction}/documents | Delete documents
|
1072
400
|
*BudgeaClient::ProvidersApi* | [**users_id_user_accounts_id_account_transactions_id_transaction_documents_get**](docs/ProvidersApi.md#users_id_user_accounts_id_account_transactions_id_transaction_documents_get) | **GET** /users/{id_user}/accounts/{id_account}/transactions/{id_transaction}/documents | Get documents
|
1073
401
|
*BudgeaClient::ProvidersApi* | [**users_id_user_accounts_id_account_transactions_id_transaction_documents_id_document_delete**](docs/ProvidersApi.md#users_id_user_accounts_id_account_transactions_id_transaction_documents_id_document_delete) | **DELETE** /users/{id_user}/accounts/{id_account}/transactions/{id_transaction}/documents/{id_document} | Delete a document
|
@@ -1162,7 +490,7 @@ Class | Method | HTTP request | Description
|
|
1162
490
|
*BudgeaClient::TermsApi* | [**terms_post**](docs/TermsApi.md#terms_post) | **POST** /terms | Register a version of 'Terms of Service' in database
|
1163
491
|
*BudgeaClient::TermsApi* | [**users_id_user_terms_get**](docs/TermsApi.md#users_id_user_terms_get) | **GET** /users/{id_user}/terms | Get active terms object for a specific user, only one terms can be active
|
1164
492
|
*BudgeaClient::TermsApi* | [**users_id_user_terms_post**](docs/TermsApi.md#users_id_user_terms_post) | **POST** /users/{id_user}/terms | Register user's consent for a specific terms id
|
1165
|
-
*BudgeaClient::TransfersApi* | [**users_id_user_accounts_id_account_recipients_get**](docs/TransfersApi.md#users_id_user_accounts_id_account_recipients_get) | **GET** /users/{id_user}/accounts/{id_account}/recipients | Returns the list of recipients
|
493
|
+
*BudgeaClient::TransfersApi* | [**users_id_user_accounts_id_account_recipients_get**](docs/TransfersApi.md#users_id_user_accounts_id_account_recipients_get) | **GET** /users/{id_user}/accounts/{id_account}/recipients | Returns the list of recipients.
|
1166
494
|
*BudgeaClient::TransfersApi* | [**users_id_user_accounts_id_account_recipients_id_recipient_post**](docs/TransfersApi.md#users_id_user_accounts_id_account_recipients_id_recipient_post) | **POST** /users/{id_user}/accounts/{id_account}/recipients/{id_recipient} | Continue addition of a recipient.
|
1167
495
|
*BudgeaClient::TransfersApi* | [**users_id_user_accounts_id_account_recipients_id_recipient_transfers_get**](docs/TransfersApi.md#users_id_user_accounts_id_account_recipients_id_recipient_transfers_get) | **GET** /users/{id_user}/accounts/{id_account}/recipients/{id_recipient}/transfers | Get transfers
|
1168
496
|
*BudgeaClient::TransfersApi* | [**users_id_user_accounts_id_account_recipients_id_recipient_transfers_id_transfer_delete**](docs/TransfersApi.md#users_id_user_accounts_id_account_recipients_id_recipient_transfers_id_transfer_delete) | **DELETE** /users/{id_user}/accounts/{id_account}/recipients/{id_recipient}/transfers/{id_transfer} | Cancel a transfer.
|
@@ -1172,7 +500,7 @@ Class | Method | HTTP request | Description
|
|
1172
500
|
*BudgeaClient::TransfersApi* | [**users_id_user_accounts_id_account_transfers_id_transfer_delete**](docs/TransfersApi.md#users_id_user_accounts_id_account_transfers_id_transfer_delete) | **DELETE** /users/{id_user}/accounts/{id_account}/transfers/{id_transfer} | Cancel a transfer.
|
1173
501
|
*BudgeaClient::TransfersApi* | [**users_id_user_accounts_id_account_transfers_id_transfer_post**](docs/TransfersApi.md#users_id_user_accounts_id_account_transfers_id_transfer_post) | **POST** /users/{id_user}/accounts/{id_account}/transfers/{id_transfer} | Execute or edit a Transfer.
|
1174
502
|
*BudgeaClient::TransfersApi* | [**users_id_user_accounts_id_account_transfers_post**](docs/TransfersApi.md#users_id_user_accounts_id_account_transfers_post) | **POST** /users/{id_user}/accounts/{id_account}/transfers | Create a transfer object.
|
1175
|
-
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_accounts_id_account_recipients_get**](docs/TransfersApi.md#users_id_user_connections_id_connection_accounts_id_account_recipients_get) | **GET** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/recipients | Returns the list of recipients
|
503
|
+
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_accounts_id_account_recipients_get**](docs/TransfersApi.md#users_id_user_connections_id_connection_accounts_id_account_recipients_get) | **GET** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/recipients | Returns the list of recipients.
|
1176
504
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_accounts_id_account_recipients_id_recipient_post**](docs/TransfersApi.md#users_id_user_connections_id_connection_accounts_id_account_recipients_id_recipient_post) | **POST** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/recipients/{id_recipient} | Continue addition of a recipient.
|
1177
505
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_accounts_id_account_recipients_id_recipient_transfers_get**](docs/TransfersApi.md#users_id_user_connections_id_connection_accounts_id_account_recipients_id_recipient_transfers_get) | **GET** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/recipients/{id_recipient}/transfers | Get transfers
|
1178
506
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_accounts_id_account_recipients_id_recipient_transfers_id_transfer_delete**](docs/TransfersApi.md#users_id_user_connections_id_connection_accounts_id_account_recipients_id_recipient_transfers_id_transfer_delete) | **DELETE** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/recipients/{id_recipient}/transfers/{id_transfer} | Cancel a transfer.
|
@@ -1182,7 +510,7 @@ Class | Method | HTTP request | Description
|
|
1182
510
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_accounts_id_account_transfers_id_transfer_delete**](docs/TransfersApi.md#users_id_user_connections_id_connection_accounts_id_account_transfers_id_transfer_delete) | **DELETE** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/transfers/{id_transfer} | Cancel a transfer.
|
1183
511
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_accounts_id_account_transfers_id_transfer_post**](docs/TransfersApi.md#users_id_user_connections_id_connection_accounts_id_account_transfers_id_transfer_post) | **POST** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/transfers/{id_transfer} | Execute or edit a Transfer.
|
1184
512
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_accounts_id_account_transfers_post**](docs/TransfersApi.md#users_id_user_connections_id_connection_accounts_id_account_transfers_post) | **POST** /users/{id_user}/connections/{id_connection}/accounts/{id_account}/transfers | Create a transfer object.
|
1185
|
-
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_recipients_get**](docs/TransfersApi.md#users_id_user_connections_id_connection_recipients_get) | **GET** /users/{id_user}/connections/{id_connection}/recipients | Returns the list of recipients
|
513
|
+
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_recipients_get**](docs/TransfersApi.md#users_id_user_connections_id_connection_recipients_get) | **GET** /users/{id_user}/connections/{id_connection}/recipients | Returns the list of recipients.
|
1186
514
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_recipients_id_recipient_post**](docs/TransfersApi.md#users_id_user_connections_id_connection_recipients_id_recipient_post) | **POST** /users/{id_user}/connections/{id_connection}/recipients/{id_recipient} | Continue addition of a recipient.
|
1187
515
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_recipients_id_recipient_transfers_get**](docs/TransfersApi.md#users_id_user_connections_id_connection_recipients_id_recipient_transfers_get) | **GET** /users/{id_user}/connections/{id_connection}/recipients/{id_recipient}/transfers | Get transfers
|
1188
516
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_recipients_id_recipient_transfers_id_transfer_delete**](docs/TransfersApi.md#users_id_user_connections_id_connection_recipients_id_recipient_transfers_id_transfer_delete) | **DELETE** /users/{id_user}/connections/{id_connection}/recipients/{id_recipient}/transfers/{id_transfer} | Cancel a transfer.
|
@@ -1192,7 +520,7 @@ Class | Method | HTTP request | Description
|
|
1192
520
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_transfers_id_transfer_delete**](docs/TransfersApi.md#users_id_user_connections_id_connection_transfers_id_transfer_delete) | **DELETE** /users/{id_user}/connections/{id_connection}/transfers/{id_transfer} | Cancel a transfer.
|
1193
521
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_transfers_id_transfer_post**](docs/TransfersApi.md#users_id_user_connections_id_connection_transfers_id_transfer_post) | **POST** /users/{id_user}/connections/{id_connection}/transfers/{id_transfer} | Execute or edit a Transfer.
|
1194
522
|
*BudgeaClient::TransfersApi* | [**users_id_user_connections_id_connection_transfers_post**](docs/TransfersApi.md#users_id_user_connections_id_connection_transfers_post) | **POST** /users/{id_user}/connections/{id_connection}/transfers | Create a transfer object.
|
1195
|
-
*BudgeaClient::TransfersApi* | [**users_id_user_recipients_get**](docs/TransfersApi.md#users_id_user_recipients_get) | **GET** /users/{id_user}/recipients | Returns the list of recipients
|
523
|
+
*BudgeaClient::TransfersApi* | [**users_id_user_recipients_get**](docs/TransfersApi.md#users_id_user_recipients_get) | **GET** /users/{id_user}/recipients | Returns the list of recipients.
|
1196
524
|
*BudgeaClient::TransfersApi* | [**users_id_user_recipients_id_recipient_post**](docs/TransfersApi.md#users_id_user_recipients_id_recipient_post) | **POST** /users/{id_user}/recipients/{id_recipient} | Continue addition of a recipient.
|
1197
525
|
*BudgeaClient::TransfersApi* | [**users_id_user_recipients_id_recipient_transfers_get**](docs/TransfersApi.md#users_id_user_recipients_id_recipient_transfers_get) | **GET** /users/{id_user}/recipients/{id_recipient}/transfers | Get transfers
|
1198
526
|
*BudgeaClient::TransfersApi* | [**users_id_user_recipients_id_recipient_transfers_id_transfer_delete**](docs/TransfersApi.md#users_id_user_recipients_id_recipient_transfers_id_transfer_delete) | **DELETE** /users/{id_user}/recipients/{id_recipient}/transfers/{id_transfer} | Cancel a transfer.
|
@@ -1232,16 +560,18 @@ Class | Method | HTTP request | Description
|
|
1232
560
|
|
1233
561
|
## Documentation for Models
|
1234
562
|
|
563
|
+
- [BudgeaClient::Access](docs/Access.md)
|
1235
564
|
- [BudgeaClient::Account](docs/Account.md)
|
1236
565
|
- [BudgeaClient::AccountLog](docs/AccountLog.md)
|
1237
566
|
- [BudgeaClient::AccountType](docs/AccountType.md)
|
1238
567
|
- [BudgeaClient::Alert](docs/Alert.md)
|
1239
|
-
- [BudgeaClient::Bank](docs/Bank.md)
|
1240
|
-
- [BudgeaClient::BankCategory](docs/BankCategory.md)
|
1241
568
|
- [BudgeaClient::Category](docs/Category.md)
|
569
|
+
- [BudgeaClient::Certificate](docs/Certificate.md)
|
1242
570
|
- [BudgeaClient::Client](docs/Client.md)
|
1243
571
|
- [BudgeaClient::Connection](docs/Connection.md)
|
1244
572
|
- [BudgeaClient::ConnectionLog](docs/ConnectionLog.md)
|
573
|
+
- [BudgeaClient::Connector](docs/Connector.md)
|
574
|
+
- [BudgeaClient::ConnectorCategory](docs/ConnectorCategory.md)
|
1245
575
|
- [BudgeaClient::ConnectorLogo](docs/ConnectorLogo.md)
|
1246
576
|
- [BudgeaClient::Currency](docs/Currency.md)
|
1247
577
|
- [BudgeaClient::Device](docs/Device.md)
|
@@ -1250,6 +580,8 @@ Class | Method | HTTP request | Description
|
|
1250
580
|
- [BudgeaClient::Field](docs/Field.md)
|
1251
581
|
- [BudgeaClient::FieldValue](docs/FieldValue.md)
|
1252
582
|
- [BudgeaClient::File](docs/File.md)
|
583
|
+
- [BudgeaClient::Group](docs/Group.md)
|
584
|
+
- [BudgeaClient::HashTable](docs/HashTable.md)
|
1253
585
|
- [BudgeaClient::InlineResponse200](docs/InlineResponse200.md)
|
1254
586
|
- [BudgeaClient::InlineResponse2001](docs/InlineResponse2001.md)
|
1255
587
|
- [BudgeaClient::InlineResponse20010](docs/InlineResponse20010.md)
|
@@ -1278,6 +610,9 @@ Class | Method | HTTP request | Description
|
|
1278
610
|
- [BudgeaClient::InlineResponse20031](docs/InlineResponse20031.md)
|
1279
611
|
- [BudgeaClient::InlineResponse20032](docs/InlineResponse20032.md)
|
1280
612
|
- [BudgeaClient::InlineResponse20033](docs/InlineResponse20033.md)
|
613
|
+
- [BudgeaClient::InlineResponse20034](docs/InlineResponse20034.md)
|
614
|
+
- [BudgeaClient::InlineResponse20035](docs/InlineResponse20035.md)
|
615
|
+
- [BudgeaClient::InlineResponse20036](docs/InlineResponse20036.md)
|
1281
616
|
- [BudgeaClient::InlineResponse2004](docs/InlineResponse2004.md)
|
1282
617
|
- [BudgeaClient::InlineResponse2005](docs/InlineResponse2005.md)
|
1283
618
|
- [BudgeaClient::InlineResponse2006](docs/InlineResponse2006.md)
|
@@ -1286,10 +621,15 @@ Class | Method | HTTP request | Description
|
|
1286
621
|
- [BudgeaClient::InlineResponse2009](docs/InlineResponse2009.md)
|
1287
622
|
- [BudgeaClient::Investment](docs/Investment.md)
|
1288
623
|
- [BudgeaClient::InvestmentValue](docs/InvestmentValue.md)
|
624
|
+
- [BudgeaClient::Invite](docs/Invite.md)
|
1289
625
|
- [BudgeaClient::LockedUser](docs/LockedUser.md)
|
1290
626
|
- [BudgeaClient::OidcWhitelist](docs/OidcWhitelist.md)
|
627
|
+
- [BudgeaClient::Pocket](docs/Pocket.md)
|
1291
628
|
- [BudgeaClient::Profile](docs/Profile.md)
|
629
|
+
- [BudgeaClient::Project](docs/Project.md)
|
630
|
+
- [BudgeaClient::ProjectType](docs/ProjectType.md)
|
1292
631
|
- [BudgeaClient::Recipient](docs/Recipient.md)
|
632
|
+
- [BudgeaClient::RecipientLog](docs/RecipientLog.md)
|
1293
633
|
- [BudgeaClient::Security](docs/Security.md)
|
1294
634
|
- [BudgeaClient::Subscription](docs/Subscription.md)
|
1295
635
|
- [BudgeaClient::TermsOfService](docs/TermsOfService.md)
|
@@ -1297,9 +637,11 @@ Class | Method | HTTP request | Description
|
|
1297
637
|
- [BudgeaClient::TransactionInformation](docs/TransactionInformation.md)
|
1298
638
|
- [BudgeaClient::TransactionsCluster](docs/TransactionsCluster.md)
|
1299
639
|
- [BudgeaClient::Transfer](docs/Transfer.md)
|
640
|
+
- [BudgeaClient::TransferLog](docs/TransferLog.md)
|
1300
641
|
- [BudgeaClient::User](docs/User.md)
|
1301
642
|
- [BudgeaClient::UserAlert](docs/UserAlert.md)
|
1302
643
|
- [BudgeaClient::Webhook](docs/Webhook.md)
|
644
|
+
- [BudgeaClient::WebhookLog](docs/WebhookLog.md)
|
1303
645
|
|
1304
646
|
|
1305
647
|
## Documentation for Authorization
|