ynab 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (194) hide show
  1. checksums.yaml +7 -0
  2. data/Gemfile +7 -0
  3. data/Gemfile.lock +44 -0
  4. data/LICENSE.md +201 -0
  5. data/README.md +57 -0
  6. data/Rakefile +31 -0
  7. data/config.json +10 -0
  8. data/docs/Account.md +16 -0
  9. data/docs/AccountResponse.md +8 -0
  10. data/docs/AccountWrapper.md +8 -0
  11. data/docs/AccountsApi.md +121 -0
  12. data/docs/AccountsResponse.md +8 -0
  13. data/docs/AccountsWrapper.md +8 -0
  14. data/docs/BudgetDetail.md +22 -0
  15. data/docs/BudgetDetailResponse.md +8 -0
  16. data/docs/BudgetDetailWrapper.md +9 -0
  17. data/docs/BudgetSummary.md +12 -0
  18. data/docs/BudgetSummaryResponse.md +8 -0
  19. data/docs/BudgetSummaryWrapper.md +8 -0
  20. data/docs/BudgetsApi.md +116 -0
  21. data/docs/BulkIdWrapper.md +8 -0
  22. data/docs/BulkIds.md +9 -0
  23. data/docs/BulkResponse.md +8 -0
  24. data/docs/BulkTransactionCreateResponse.md +8 -0
  25. data/docs/BulkTransactionIds.md +8 -0
  26. data/docs/BulkTransactions.md +8 -0
  27. data/docs/CategoriesApi.md +121 -0
  28. data/docs/CategoriesResponse.md +8 -0
  29. data/docs/Category.md +15 -0
  30. data/docs/CategoryGroup.md +10 -0
  31. data/docs/CategoryGroupWithCategories.md +11 -0
  32. data/docs/CategoryGroupsWrapper.md +8 -0
  33. data/docs/CategoryResponse.md +8 -0
  34. data/docs/CategoryWrapper.md +8 -0
  35. data/docs/CurrencyFormat.md +8 -0
  36. data/docs/DateFormat.md +8 -0
  37. data/docs/ErrorDetail.md +10 -0
  38. data/docs/ErrorResponse.md +8 -0
  39. data/docs/MonthDetail.md +12 -0
  40. data/docs/MonthDetailResponse.md +8 -0
  41. data/docs/MonthDetailWrapper.md +8 -0
  42. data/docs/MonthSummariesResponse.md +8 -0
  43. data/docs/MonthSummariesWrapper.md +8 -0
  44. data/docs/MonthSummary.md +11 -0
  45. data/docs/MonthsApi.md +121 -0
  46. data/docs/Payee.md +10 -0
  47. data/docs/PayeeLocation.md +11 -0
  48. data/docs/PayeeLocationResponse.md +8 -0
  49. data/docs/PayeeLocationWrapper.md +8 -0
  50. data/docs/PayeeLocationsApi.md +179 -0
  51. data/docs/PayeeLocationsResponse.md +8 -0
  52. data/docs/PayeeLocationsWrapper.md +8 -0
  53. data/docs/PayeeResponse.md +8 -0
  54. data/docs/PayeeWrapper.md +8 -0
  55. data/docs/PayeesApi.md +121 -0
  56. data/docs/PayeesResponse.md +8 -0
  57. data/docs/PayeesWrapper.md +8 -0
  58. data/docs/SaveTransaction.md +18 -0
  59. data/docs/SaveTransactionWrapper.md +8 -0
  60. data/docs/ScheduledSubTransaction.md +14 -0
  61. data/docs/ScheduledTransactionDetail.md +19 -0
  62. data/docs/ScheduledTransactionResponse.md +8 -0
  63. data/docs/ScheduledTransactionSummary.md +18 -0
  64. data/docs/ScheduledTransactionWrapper.md +8 -0
  65. data/docs/ScheduledTransactionsApi.md +121 -0
  66. data/docs/ScheduledTransactionsResponse.md +8 -0
  67. data/docs/ScheduledTransactionsWrapper.md +8 -0
  68. data/docs/SubTransaction.md +14 -0
  69. data/docs/TransactionDetail.md +20 -0
  70. data/docs/TransactionResponse.md +8 -0
  71. data/docs/TransactionSummary.md +19 -0
  72. data/docs/TransactionWrapper.md +8 -0
  73. data/docs/TransactionsApi.md +428 -0
  74. data/docs/TransactionsResponse.md +8 -0
  75. data/docs/TransactionsWrapper.md +8 -0
  76. data/examples/budget-list.rb +25 -0
  77. data/examples/budget-month.rb +36 -0
  78. data/examples/category-balance.rb +27 -0
  79. data/lib/ynab.rb +136 -0
  80. data/lib/ynab/api/accounts_api.rb +135 -0
  81. data/lib/ynab/api/budgets_api.rb +126 -0
  82. data/lib/ynab/api/categories_api.rb +135 -0
  83. data/lib/ynab/api/months_api.rb +135 -0
  84. data/lib/ynab/api/payee_locations_api.rb +194 -0
  85. data/lib/ynab/api/payees_api.rb +135 -0
  86. data/lib/ynab/api/scheduled_transactions_api.rb +135 -0
  87. data/lib/ynab/api/transactions_api.rb +451 -0
  88. data/lib/ynab/api_client.rb +392 -0
  89. data/lib/ynab/api_error.rb +38 -0
  90. data/lib/ynab/configuration.rb +209 -0
  91. data/lib/ynab/models/account.rb +343 -0
  92. data/lib/ynab/models/account_response.rb +193 -0
  93. data/lib/ynab/models/account_wrapper.rb +193 -0
  94. data/lib/ynab/models/accounts_response.rb +193 -0
  95. data/lib/ynab/models/accounts_wrapper.rb +195 -0
  96. data/lib/ynab/models/budget_detail.rb +345 -0
  97. data/lib/ynab/models/budget_detail_response.rb +193 -0
  98. data/lib/ynab/models/budget_detail_wrapper.rb +208 -0
  99. data/lib/ynab/models/budget_summary.rb +235 -0
  100. data/lib/ynab/models/budget_summary_response.rb +193 -0
  101. data/lib/ynab/models/budget_summary_wrapper.rb +195 -0
  102. data/lib/ynab/models/bulk_id_wrapper.rb +193 -0
  103. data/lib/ynab/models/bulk_ids.rb +213 -0
  104. data/lib/ynab/models/bulk_response.rb +193 -0
  105. data/lib/ynab/models/bulk_transaction_create_response.rb +193 -0
  106. data/lib/ynab/models/bulk_transaction_ids.rb +195 -0
  107. data/lib/ynab/models/bulk_transactions.rb +195 -0
  108. data/lib/ynab/models/categories_response.rb +193 -0
  109. data/lib/ynab/models/category.rb +295 -0
  110. data/lib/ynab/models/category_group.rb +222 -0
  111. data/lib/ynab/models/category_group_with_categories.rb +239 -0
  112. data/lib/ynab/models/category_groups_wrapper.rb +195 -0
  113. data/lib/ynab/models/category_response.rb +193 -0
  114. data/lib/ynab/models/category_wrapper.rb +193 -0
  115. data/lib/ynab/models/currency_format.rb +193 -0
  116. data/lib/ynab/models/date_format.rb +193 -0
  117. data/lib/ynab/models/error_detail.rb +221 -0
  118. data/lib/ynab/models/error_response.rb +193 -0
  119. data/lib/ynab/models/month_detail.rb +253 -0
  120. data/lib/ynab/models/month_detail_response.rb +193 -0
  121. data/lib/ynab/models/month_detail_wrapper.rb +193 -0
  122. data/lib/ynab/models/month_summaries_response.rb +193 -0
  123. data/lib/ynab/models/month_summaries_wrapper.rb +195 -0
  124. data/lib/ynab/models/month_summary.rb +236 -0
  125. data/lib/ynab/models/payee.rb +222 -0
  126. data/lib/ynab/models/payee_location.rb +235 -0
  127. data/lib/ynab/models/payee_location_response.rb +193 -0
  128. data/lib/ynab/models/payee_location_wrapper.rb +193 -0
  129. data/lib/ynab/models/payee_locations_response.rb +193 -0
  130. data/lib/ynab/models/payee_locations_wrapper.rb +195 -0
  131. data/lib/ynab/models/payee_response.rb +193 -0
  132. data/lib/ynab/models/payee_wrapper.rb +193 -0
  133. data/lib/ynab/models/payees_response.rb +193 -0
  134. data/lib/ynab/models/payees_wrapper.rb +195 -0
  135. data/lib/ynab/models/save_transaction.rb +346 -0
  136. data/lib/ynab/models/save_transaction_wrapper.rb +193 -0
  137. data/lib/ynab/models/scheduled_sub_transaction.rb +279 -0
  138. data/lib/ynab/models/scheduled_transaction_detail.rb +387 -0
  139. data/lib/ynab/models/scheduled_transaction_response.rb +193 -0
  140. data/lib/ynab/models/scheduled_transaction_summary.rb +370 -0
  141. data/lib/ynab/models/scheduled_transaction_wrapper.rb +193 -0
  142. data/lib/ynab/models/scheduled_transactions_response.rb +193 -0
  143. data/lib/ynab/models/scheduled_transactions_wrapper.rb +195 -0
  144. data/lib/ynab/models/sub_transaction.rb +279 -0
  145. data/lib/ynab/models/transaction_detail.rb +401 -0
  146. data/lib/ynab/models/transaction_response.rb +193 -0
  147. data/lib/ynab/models/transaction_summary.rb +384 -0
  148. data/lib/ynab/models/transaction_wrapper.rb +193 -0
  149. data/lib/ynab/models/transactions_response.rb +193 -0
  150. data/lib/ynab/models/transactions_wrapper.rb +195 -0
  151. data/lib/ynab/version.rb +15 -0
  152. data/pkg/ynab-0.1.0.gem +0 -0
  153. data/spec-v1-swagger.json +2121 -0
  154. data/spec/api/accounts_spec.rb +56 -0
  155. data/spec/api/budgets_spec.rb +55 -0
  156. data/spec/api/categories_spec.rb +57 -0
  157. data/spec/api/months_spec.rb +57 -0
  158. data/spec/api/payee_locations_spec.rb +57 -0
  159. data/spec/api/payees_spec.rb +56 -0
  160. data/spec/api/scheduled_transactions_spec.rb +56 -0
  161. data/spec/api/transactions_spec.rb +122 -0
  162. data/spec/fixtures/.DS_Store +0 -0
  163. data/spec/fixtures/vcr_cassettes/account.yml +46 -0
  164. data/spec/fixtures/vcr_cassettes/accounts.yml +46 -0
  165. data/spec/fixtures/vcr_cassettes/accounts_unauthorized.yml +49 -0
  166. data/spec/fixtures/vcr_cassettes/budget.yml +1413 -0
  167. data/spec/fixtures/vcr_cassettes/budgets.yml +49 -0
  168. data/spec/fixtures/vcr_cassettes/budgets_unauthorized.yml +49 -0
  169. data/spec/fixtures/vcr_cassettes/bulk_transactions.yml +46 -0
  170. data/spec/fixtures/vcr_cassettes/categories.yml +67 -0
  171. data/spec/fixtures/vcr_cassettes/categories_unauthorized.yml +49 -0
  172. data/spec/fixtures/vcr_cassettes/category.yml +46 -0
  173. data/spec/fixtures/vcr_cassettes/create_transaction.yml +46 -0
  174. data/spec/fixtures/vcr_cassettes/month.yml +59 -0
  175. data/spec/fixtures/vcr_cassettes/months.yml +47 -0
  176. data/spec/fixtures/vcr_cassettes/months_unauthorized.yml +49 -0
  177. data/spec/fixtures/vcr_cassettes/payee.yml +47 -0
  178. data/spec/fixtures/vcr_cassettes/payee_location.yml +46 -0
  179. data/spec/fixtures/vcr_cassettes/payee_locations.yml +46 -0
  180. data/spec/fixtures/vcr_cassettes/payee_locations_unauthorized.yml +49 -0
  181. data/spec/fixtures/vcr_cassettes/payees.yml +51 -0
  182. data/spec/fixtures/vcr_cassettes/payees_unauthorized.yml +49 -0
  183. data/spec/fixtures/vcr_cassettes/scheduled_transaction.yml +46 -0
  184. data/spec/fixtures/vcr_cassettes/scheduled_transactions.yml +46 -0
  185. data/spec/fixtures/vcr_cassettes/scheduled_transactions_unauthorized.yml +49 -0
  186. data/spec/fixtures/vcr_cassettes/transaction.yml +46 -0
  187. data/spec/fixtures/vcr_cassettes/transactions.yml +46 -0
  188. data/spec/fixtures/vcr_cassettes/transactions_unauthorized.yml +49 -0
  189. data/spec/fixtures/vcr_cassettes/update_transaction.yml +46 -0
  190. data/spec/spec_helper.rb +18 -0
  191. data/swagger-templates/api_client.mustache +386 -0
  192. data/swagger-templates/gemspec.mustache +37 -0
  193. data/ynab.gemspec +40 -0
  194. metadata +353 -0
@@ -0,0 +1,8 @@
1
+ # YnabApi::AccountsResponse
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **data** | [**AccountsWrapper**](AccountsWrapper.md) | |
7
+
8
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::AccountsWrapper
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **accounts** | [**Array<Account>**](Account.md) | |
7
+
8
+
@@ -0,0 +1,22 @@
1
+ # YnabApi::BudgetDetail
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **id** | **String** | |
7
+ **name** | **String** | |
8
+ **last_modified_on** | **DateTime** | The last time any changes were made to the budget from either a web or mobile client. | [optional]
9
+ **date_format** | [**DateFormat**](DateFormat.md) | | [optional]
10
+ **currency_format** | [**CurrencyFormat**](CurrencyFormat.md) | | [optional]
11
+ **accounts** | [**Array<Account>**](Account.md) | | [optional]
12
+ **payees** | [**Array<Payee>**](Payee.md) | | [optional]
13
+ **payee_locations** | [**Array<PayeeLocation>**](PayeeLocation.md) | | [optional]
14
+ **category_groups** | [**Array<CategoryGroup>**](CategoryGroup.md) | | [optional]
15
+ **categories** | [**Array<Category>**](Category.md) | | [optional]
16
+ **months** | [**Array<MonthDetail>**](MonthDetail.md) | | [optional]
17
+ **transactions** | [**Array<TransactionSummary>**](TransactionSummary.md) | | [optional]
18
+ **subtransactions** | [**Array<SubTransaction>**](SubTransaction.md) | | [optional]
19
+ **scheduled_transactions** | [**Array<ScheduledTransactionSummary>**](ScheduledTransactionSummary.md) | | [optional]
20
+ **scheduled_subtransactions** | [**Array<ScheduledSubTransaction>**](ScheduledSubTransaction.md) | | [optional]
21
+
22
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::BudgetDetailResponse
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **data** | [**BudgetDetailWrapper**](BudgetDetailWrapper.md) | |
7
+
8
+
@@ -0,0 +1,9 @@
1
+ # YnabApi::BudgetDetailWrapper
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **budget** | [**BudgetDetail**](BudgetDetail.md) | |
7
+ **server_knowledge** | **Float** | The knowledge of the server |
8
+
9
+
@@ -0,0 +1,12 @@
1
+ # YnabApi::BudgetSummary
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **id** | **String** | |
7
+ **name** | **String** | |
8
+ **last_modified_on** | **DateTime** | The last time any changes were made to the budget from either a web or mobile client. | [optional]
9
+ **date_format** | [**DateFormat**](DateFormat.md) | | [optional]
10
+ **currency_format** | [**CurrencyFormat**](CurrencyFormat.md) | | [optional]
11
+
12
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::BudgetSummaryResponse
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **data** | [**BudgetSummaryWrapper**](BudgetSummaryWrapper.md) | |
7
+
8
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::BudgetSummaryWrapper
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **budgets** | [**Array<BudgetSummary>**](BudgetSummary.md) | |
7
+
8
+
@@ -0,0 +1,116 @@
1
+ # YnabApi::BudgetsApi
2
+
3
+ All URIs are relative to *https://api.youneedabudget.com/papi/v1*
4
+
5
+ Method | HTTP request | Description
6
+ ------------- | ------------- | -------------
7
+ [**get_budget_by_id**](BudgetsApi.md#get_budget_by_id) | **GET** /budgets/{budget_id} | Single budget
8
+ [**get_budgets**](BudgetsApi.md#get_budgets) | **GET** /budgets | List budgets
9
+
10
+
11
+ # **get_budget_by_id**
12
+ > BudgetDetailResponse get_budget_by_id(budget_id, opts)
13
+
14
+ Single budget
15
+
16
+ Returns a single budget with all related entities. This resource is effectively a full budget export.
17
+
18
+ ### Example
19
+ ```ruby
20
+ # load the gem
21
+ require 'ynab'
22
+ # setup authorization
23
+ YnabApi.configure do |config|
24
+ # Configure API key authorization: bearer
25
+ config.api_key['Authorization'] = 'YOUR API KEY'
26
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
27
+ #config.api_key_prefix['Authorization'] = 'Bearer'
28
+ end
29
+
30
+ api_instance = YnabApi::BudgetsApi.new
31
+
32
+ budget_id = "budget_id_example" # String | The ID of the Budget.
33
+
34
+ opts = {
35
+ last_knowledge_of_server: 8.14 # Float | The starting server knowledge. If provided, only entities that have changed since last_knowledge_of_server will be included.
36
+ }
37
+
38
+ begin
39
+ #Single budget
40
+ result = api_instance.get_budget_by_id(budget_id, opts)
41
+ p result
42
+ rescue YnabApi::ApiError => e
43
+ puts "Exception when calling BudgetsApi->get_budget_by_id: #{e}"
44
+ end
45
+ ```
46
+
47
+ ### Parameters
48
+
49
+ Name | Type | Description | Notes
50
+ ------------- | ------------- | ------------- | -------------
51
+ **budget_id** | [**String**](.md)| The ID of the Budget. |
52
+ **last_knowledge_of_server** | **Float**| The starting server knowledge. If provided, only entities that have changed since last_knowledge_of_server will be included. | [optional]
53
+
54
+ ### Return type
55
+
56
+ [**BudgetDetailResponse**](BudgetDetailResponse.md)
57
+
58
+ ### Authorization
59
+
60
+ [bearer](../README.md#bearer)
61
+
62
+ ### HTTP request headers
63
+
64
+ - **Content-Type**: Not defined
65
+ - **Accept**: application/json
66
+
67
+
68
+
69
+ # **get_budgets**
70
+ > BudgetSummaryResponse get_budgets
71
+
72
+ List budgets
73
+
74
+ Returns budgets list with summary information.
75
+
76
+ ### Example
77
+ ```ruby
78
+ # load the gem
79
+ require 'ynab'
80
+ # setup authorization
81
+ YnabApi.configure do |config|
82
+ # Configure API key authorization: bearer
83
+ config.api_key['Authorization'] = 'YOUR API KEY'
84
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
85
+ #config.api_key_prefix['Authorization'] = 'Bearer'
86
+ end
87
+
88
+ api_instance = YnabApi::BudgetsApi.new
89
+
90
+ begin
91
+ #List budgets
92
+ result = api_instance.get_budgets
93
+ p result
94
+ rescue YnabApi::ApiError => e
95
+ puts "Exception when calling BudgetsApi->get_budgets: #{e}"
96
+ end
97
+ ```
98
+
99
+ ### Parameters
100
+ This endpoint does not need any parameter.
101
+
102
+ ### Return type
103
+
104
+ [**BudgetSummaryResponse**](BudgetSummaryResponse.md)
105
+
106
+ ### Authorization
107
+
108
+ [bearer](../README.md#bearer)
109
+
110
+ ### HTTP request headers
111
+
112
+ - **Content-Type**: Not defined
113
+ - **Accept**: application/json
114
+
115
+
116
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::BulkIdWrapper
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **bulk** | [**BulkIds**](BulkIds.md) | |
7
+
8
+
data/docs/BulkIds.md ADDED
@@ -0,0 +1,9 @@
1
+ # YnabApi::BulkIds
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **transaction_ids** | **Array<String>** | The list of Transaction IDs that were created. |
7
+ **duplicate_import_ids** | **Array<String>** | If any Transactions were not created because they had an import_id matching a transaction already on the same account, the specified import_id(s) will be included in this list. |
8
+
9
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::BulkResponse
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **data** | [**BulkIdWrapper**](BulkIdWrapper.md) | |
7
+
8
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::BulkTransactionCreateResponse
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **data** | [**BulkTransactionIds**](BulkTransactionIds.md) | |
7
+
8
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::BulkTransactionIds
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **transaction_ids** | **Array<String>** | |
7
+
8
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::BulkTransactions
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **transactions** | [**Array<SaveTransaction>**](SaveTransaction.md) | |
7
+
8
+
@@ -0,0 +1,121 @@
1
+ # YnabApi::CategoriesApi
2
+
3
+ All URIs are relative to *https://api.youneedabudget.com/papi/v1*
4
+
5
+ Method | HTTP request | Description
6
+ ------------- | ------------- | -------------
7
+ [**get_categories**](CategoriesApi.md#get_categories) | **GET** /budgets/{budget_id}/categories | List categories
8
+ [**get_category_by_id**](CategoriesApi.md#get_category_by_id) | **GET** /budgets/{budget_id}/categories/{category_id} | Single category
9
+
10
+
11
+ # **get_categories**
12
+ > CategoriesResponse get_categories(budget_id)
13
+
14
+ List categories
15
+
16
+ Returns all categories grouped by category group.
17
+
18
+ ### Example
19
+ ```ruby
20
+ # load the gem
21
+ require 'ynab'
22
+ # setup authorization
23
+ YnabApi.configure do |config|
24
+ # Configure API key authorization: bearer
25
+ config.api_key['Authorization'] = 'YOUR API KEY'
26
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
27
+ #config.api_key_prefix['Authorization'] = 'Bearer'
28
+ end
29
+
30
+ api_instance = YnabApi::CategoriesApi.new
31
+
32
+ budget_id = "budget_id_example" # String | The ID of the Budget.
33
+
34
+
35
+ begin
36
+ #List categories
37
+ result = api_instance.get_categories(budget_id)
38
+ p result
39
+ rescue YnabApi::ApiError => e
40
+ puts "Exception when calling CategoriesApi->get_categories: #{e}"
41
+ end
42
+ ```
43
+
44
+ ### Parameters
45
+
46
+ Name | Type | Description | Notes
47
+ ------------- | ------------- | ------------- | -------------
48
+ **budget_id** | [**String**](.md)| The ID of the Budget. |
49
+
50
+ ### Return type
51
+
52
+ [**CategoriesResponse**](CategoriesResponse.md)
53
+
54
+ ### Authorization
55
+
56
+ [bearer](../README.md#bearer)
57
+
58
+ ### HTTP request headers
59
+
60
+ - **Content-Type**: Not defined
61
+ - **Accept**: application/json
62
+
63
+
64
+
65
+ # **get_category_by_id**
66
+ > CategoryResponse get_category_by_id(budget_id, category_id)
67
+
68
+ Single category
69
+
70
+ Returns a single category
71
+
72
+ ### Example
73
+ ```ruby
74
+ # load the gem
75
+ require 'ynab'
76
+ # setup authorization
77
+ YnabApi.configure do |config|
78
+ # Configure API key authorization: bearer
79
+ config.api_key['Authorization'] = 'YOUR API KEY'
80
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
81
+ #config.api_key_prefix['Authorization'] = 'Bearer'
82
+ end
83
+
84
+ api_instance = YnabApi::CategoriesApi.new
85
+
86
+ budget_id = "budget_id_example" # String | The ID of the Budget.
87
+
88
+ category_id = "category_id_example" # String | The ID of the Category.
89
+
90
+
91
+ begin
92
+ #Single category
93
+ result = api_instance.get_category_by_id(budget_id, category_id)
94
+ p result
95
+ rescue YnabApi::ApiError => e
96
+ puts "Exception when calling CategoriesApi->get_category_by_id: #{e}"
97
+ end
98
+ ```
99
+
100
+ ### Parameters
101
+
102
+ Name | Type | Description | Notes
103
+ ------------- | ------------- | ------------- | -------------
104
+ **budget_id** | [**String**](.md)| The ID of the Budget. |
105
+ **category_id** | [**String**](.md)| The ID of the Category. |
106
+
107
+ ### Return type
108
+
109
+ [**CategoryResponse**](CategoryResponse.md)
110
+
111
+ ### Authorization
112
+
113
+ [bearer](../README.md#bearer)
114
+
115
+ ### HTTP request headers
116
+
117
+ - **Content-Type**: Not defined
118
+ - **Accept**: application/json
119
+
120
+
121
+
@@ -0,0 +1,8 @@
1
+ # YnabApi::CategoriesResponse
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **data** | [**CategoryGroupsWrapper**](CategoryGroupsWrapper.md) | |
7
+
8
+
data/docs/Category.md ADDED
@@ -0,0 +1,15 @@
1
+ # YnabApi::Category
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **id** | **String** | |
7
+ **category_group_id** | **String** | |
8
+ **name** | **String** | |
9
+ **hidden** | **BOOLEAN** | Whether or not the category is hidden |
10
+ **note** | **String** | |
11
+ **budgeted** | **Float** | Budgeted amount in current month in milliunits format |
12
+ **activity** | **Float** | Activity amount in current month in milliunits format |
13
+ **balance** | **Float** | Balance in current month in milliunits format |
14
+
15
+
@@ -0,0 +1,10 @@
1
+ # YnabApi::CategoryGroup
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **id** | **String** | |
7
+ **name** | **String** | |
8
+ **hidden** | **BOOLEAN** | Whether or not the category group is hidden |
9
+
10
+
@@ -0,0 +1,11 @@
1
+ # YnabApi::CategoryGroupWithCategories
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **id** | **String** | |
7
+ **name** | **String** | |
8
+ **hidden** | **BOOLEAN** | Whether or not the category group is hidden |
9
+ **categories** | [**Array<Category>**](Category.md) | Category group categories |
10
+
11
+