예산이 필요합니다(독립 게시자)
YNAB(예산 필요)를 사용하면 사용자 고유의 예산과 상호 작용할 개인 애플리케이션을 빌드하거나 다른 YNABer가 권한을 부여하고 사용할 수 있는 애플리케이션을 빌드할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 트로이 테일러 |
| URL | https://www.hitachisolutions.com |
| 전자 메일 | ttaylor@hitachisolutions.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 트로이 테일러 |
| 웹 사이트 | https://www.youneedabudget.com/ |
| 개인 정보 보호 정책 | https://www.youneedabudget.com/privacy-policy/ |
| 카테고리 | 금융 |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 액세스 토큰('Bearer AccessToken' 형식) | 시큐어스트링 (보안 문자열) | 이 API에 대한 액세스 토큰('Bearer AccessToken' 형식) | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| ID로 계정 가져오기 |
단일 계정을 반환합니다. |
| ID로 수취인 가져오기 |
단일 수취인을 반환합니다. |
| ID로 수취인 위치 가져오기 |
단일 수취인 위치를 반환합니다. |
| ID로 예약된 트랜잭션 가져오기 |
예약된 단일 트랜잭션을 반환합니다. |
| ID별 범주 가져오기 |
단일 범주를 반환합니다. 금액(예산, 활동, 잔액 등)은 현재 예산 월(UTC)과 관련이 있습니다. |
| ID별 예산 가져오기 |
모든 관련 엔터티를 사용하여 단일 예산을 반환합니다. 이 리소스는 사실상 전체 예산 내보내기입니다. |
| ID별 예산 설정 가져오기 |
예산에 대한 설정을 반환합니다. |
| ID별 월 범주 가져오기 |
특정 예산 월의 단일 범주를 반환합니다. 금액(예산, 활동, 잔액 등)은 현재 예산 월(UTC)과 관련이 있습니다. |
| ID별 트랜잭션 가져오기 |
단일 트랜잭션을 반환합니다. |
| 거래처 만들기 |
새 계정을 만듭니다. |
| 계정 가져오기 |
모든 계정을 반환합니다. |
| 계정별 트랜잭션 가져오기 |
지정된 계정에 대한 모든 트랜잭션을 반환합니다. |
| 대량 트랜잭션 만들기 |
여러 트랜잭션을 만듭니다. 이 엔드포인트는 여전히 지원되지만 'POST /budgets/{budget_id}/transactions'를 사용하여 여러 트랜잭션을 만드는 것이 좋습니다. |
| 범주 가져오기 |
범주 그룹별로 그룹화된 모든 범주를 반환합니다. 금액(예산, 활동, 잔액 등)은 현재 예산 월(UTC)과 관련이 있습니다. |
| 범주별 트랜잭션 가져오기 |
지정된 범주에 대한 모든 트랜잭션을 반환합니다. |
| 사용자 가져오기 |
인증된 사용자 정보를 반환합니다. |
| 수취인 가져오기 |
모든 수취인을 반환합니다. |
| 수취인 위치 가져오기 |
모든 수취인 위치를 반환합니다. |
| 수취인별 수취인 위치 가져오기 |
지정된 수취인의 모든 수취인 위치를 반환합니다. |
| 수취인별 트랜잭션 가져오기 |
지정된 수취인에 대한 모든 트랜잭션을 반환합니다. |
| 업데이트 월 범주 |
특정 월의 범주를 업데이트합니다. 금액만 |
| 예산 가져오기 |
요약 정보가 포함된 예산 목록을 반환합니다. |
| 예산 월 가져오기 |
단일 예산 월을 반환합니다. |
| 예산 월 가져오기 |
모든 예산 월을 반환합니다. |
| 예약된 트랜잭션 가져오기 |
예약된 모든 트랜잭션을 반환합니다. |
| 트랜잭션 가져오기 |
예산 트랜잭션을 반환합니다. |
| 트랜잭션 가져오기 |
지정된 예산에 대해 연결된 모든 계정에서 사용 가능한 트랜잭션을 가져옵니다. 연결된 계정을 사용하면 지정된 금융 기관에서 직접 트랜잭션을 가져올 수 있으며 이 엔드포인트는 해당 가져오기를 시작합니다. 이 엔드포인트에 요청을 보내는 것은 웹 애플리케이션의 각 계정에서 "가져오기"를 클릭하거나 모바일 애플리케이션에서 "새 트랜잭션" 배너를 탭하는 것과 같습니다. 이 엔드포인트에 대한 응답에는 가져온 트랜잭션 ID가 포함됩니다. |
| 트랜잭션 만들기 |
단일 트랜잭션 또는 여러 트랜잭션을 만듭니다. 개체가 포함된 |
| 트랜잭션 업데이트 |
단일 트랜잭션을 업데이트합니다. |
| 트랜잭션 업데이트 |
여러 트랜잭션을 업데이트합니다( 또는 |
ID로 계정 가져오기
단일 계정을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
계정 ID
|
account_id | True | uuid |
계정의 식별자입니다. |
반환
- 계정 응답
- AccountResponse
ID로 수취인 가져오기
단일 수취인을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
수취인 ID
|
payee_id | True | string |
수취인의 식별자입니다. |
반환
- 수취인 응답
- PayeeResponse
ID로 수취인 위치 가져오기
단일 수취인 위치를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
수신자 위치 ID
|
payee_location_id | True | string |
수취인 위치의 식별자입니다. |
반환
- 수신자 위치 응답
- PayeeLocationResponse
ID로 예약된 트랜잭션 가져오기
예약된 단일 트랜잭션을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
예약된 트랜잭션 ID
|
scheduled_transaction_id | True | string |
예약된 트랜잭션의 식별자입니다. |
반환
- 예약된 트랜잭션 응답
- ScheduledTransactionResponse
ID별 범주 가져오기
단일 범주를 반환합니다. 금액(예산, 활동, 잔액 등)은 현재 예산 월(UTC)과 관련이 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
범주 ID
|
category_id | True | string |
범주의 식별자입니다. |
반환
- 범주 응답
- CategoryResponse
ID별 예산 가져오기
모든 관련 엔터티를 사용하여 단일 예산을 반환합니다. 이 리소스는 사실상 전체 예산 내보내기입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. |
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 예산 세부 정보 응답
- BudgetDetailResponse
ID별 예산 설정 가져오기
예산에 대한 설정을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
반환
- 예산 설정 응답
- BudgetSettingsResponse
ID별 월 범주 가져오기
특정 예산 월의 단일 범주를 반환합니다. 금액(예산, 활동, 잔액 등)은 현재 예산 월(UTC)과 관련이 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
Month
|
month | True | date |
ISO 형식의 예산 월(예: 2016-12-01)입니다. ("current"를 사용하여 현재 달력 월(UTC)을 지정할 수도 있습니다.) |
|
범주 ID
|
category_id | True | string |
범주의 식별자입니다. |
반환
- 범주 응답
- CategoryResponse
ID별 트랜잭션 가져오기
단일 트랜잭션을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
트랜잭션 ID
|
transaction_id | True | string |
트랜잭션의 식별자입니다. |
반환
- 트랜잭션 응답
- TransactionResponse
거래처 만들기
새 계정을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자("마지막 사용"을 사용하여 마지막으로 사용한 예산을 지정할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
이름
|
name | True | string |
계정 이름입니다. |
|
Type2
|
type | True | string |
계정 유형 |
|
저울
|
balance | True | integer |
계정의 현재 잔액(밀리니트 형식)입니다. |
반환
- 계정 응답
- AccountResponse
계정 가져오기
모든 계정을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 계정 응답
- AccountsResponse
계정별 트랜잭션 가져오기
지정된 계정에 대한 모든 트랜잭션을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
계정 ID
|
account_id | True | string |
계정의 식별자입니다. |
|
이후 날짜
|
since_date | date |
지정된 경우 이 날짜 이후의 트랜잭션만 포함됩니다. 날짜는 ISO 형식이어야 합니다(예: 2016-12-30). |
|
|
유형
|
type | string |
지정된 경우 지정된 형식의 트랜잭션만 포함됩니다. "분류되지 않음" 및 "승인되지 않음"은 현재 지원됩니다. |
|
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 트랜잭션 응답
- TransactionsResponse
대량 트랜잭션 만들기
여러 트랜잭션을 만듭니다. 이 엔드포인트는 여전히 지원되지만 'POST /budgets/{budget_id}/transactions'를 사용하여 여러 트랜잭션을 만드는 것이 좋습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
계정 ID
|
account_id | True | string |
계정 식별자입니다. |
|
날짜
|
date | True | date |
ISO 형식의 트랜잭션 날짜(예: 2016-12-01)입니다. 이후 날짜(예약된 트랜잭션)는 허용되지 않습니다. 분할 트랜잭션 날짜는 변경할 수 없으며 다른 날짜가 제공되면 무시됩니다. |
|
금액
|
amount | True | integer |
트랜잭션 금액(밀리니트 형식)입니다. 분할 트랜잭션 금액은 변경할 수 없으며 다른 금액이 제공되면 무시됩니다. |
|
수취인 ID
|
payee_id | uuid |
트랜잭션에 대한 수취인입니다. 두 계정 간에 이체를 만들려면 대상 계정을 가리키는 계정 이체 수취인을 사용합니다. 계정 이체 수취인은 계정 리소스에서와 같이 |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
트랜잭션의 범주입니다. 분할 트랜잭션을 구성하려면 null을 |
|
|
메모
|
memo | string |
메모입니다. |
|
|
지워짐
|
cleared | string |
트랜잭션의 지워진 상태입니다. |
|
|
승인됨
|
approved | boolean |
트랜잭션이 승인되었는지 여부입니다. 제공되지 않으면 트랜잭션은 기본적으로 승인되지 않습니다. |
|
|
플래그 색
|
flag_color | string |
트랜잭션 플래그입니다. |
|
|
ID 가져오기
|
import_id | string |
지정된 경우 새 트랜잭션에 할당 |
|
|
금액
|
amount | True | integer |
밀리니트 형식의 하위 변환 양입니다. |
|
수취인 ID
|
payee_id | uuid |
하위 번역에 대한 수취인입니다. |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
하위 번역의 범주입니다. 신용 카드 결제 범주는 허용되지 않으며 제공된 경우 무시됩니다. |
|
|
메모
|
memo | string |
메모입니다. |
반환
- 대량 응답
- BulkResponse
범주 가져오기
범주 그룹별로 그룹화된 모든 범주를 반환합니다. 금액(예산, 활동, 잔액 등)은 현재 예산 월(UTC)과 관련이 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 범주 응답
- CategoriesResponse
범주별 트랜잭션 가져오기
지정된 범주에 대한 모든 트랜잭션을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
범주 ID
|
category_id | True | string |
범주의 식별자입니다. |
|
이후 날짜
|
since_date | date |
지정된 경우 이 날짜 이후의 트랜잭션만 포함됩니다. 날짜는 ISO 형식이어야 합니다(예: 2016-12-30). |
|
|
유형
|
type | string |
지정된 경우 지정된 형식의 트랜잭션만 포함됩니다. "분류되지 않음" 및 "승인되지 않음"은 현재 지원됩니다. |
|
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 하이브리드 트랜잭션 응답
- HybridTransactionsResponse
사용자 가져오기
수취인 가져오기
모든 수취인을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- Payees 응답
- PayeesResponse
수취인 위치 가져오기
모든 수취인 위치를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
반환
- 수취인 위치 응답
- PayeeLocationsResponse
수취인별 수취인 위치 가져오기
지정된 수취인의 모든 수취인 위치를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
수취인 ID
|
payee_id | True | string |
수취인의 식별자입니다. |
반환
- 수취인 위치 응답
- PayeeLocationsResponse
수취인별 트랜잭션 가져오기
지정된 수취인에 대한 모든 트랜잭션을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
수취인 ID
|
payee_id | True | string |
수취인의 식별자입니다. |
|
이후 날짜
|
since_date | date |
지정된 경우 이 날짜 이후의 트랜잭션만 포함됩니다. 날짜는 ISO 형식이어야 합니다(예: 2016-12-30). |
|
|
유형
|
type | string |
지정된 경우 지정된 형식의 트랜잭션만 포함됩니다. "분류되지 않음" 및 "승인되지 않음"은 현재 지원됩니다. |
|
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 하이브리드 트랜잭션 응답
- HybridTransactionsResponse
업데이트 월 범주
특정 월의 범주를 업데이트합니다. 금액만 budgeted 업데이트할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
Month
|
month | True | date |
ISO 형식의 예산 월(예: 2016-12-01)입니다. ("current"를 사용하여 현재 달력 월(UTC)을 지정할 수도 있습니다.) |
|
범주 ID
|
category_id | True | string |
범주의 식별자입니다. |
|
예산
|
budgeted | True | integer |
예산 금액(밀리니트 형식)입니다. |
반환
- 범주 응답 저장
- SaveCategoryResponse
예산 가져오기
요약 정보가 포함된 예산 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
계정 포함
|
include_accounts | boolean |
예산 계정 목록을 포함할지 여부입니다. |
반환
- 예산 요약 응답
- BudgetSummaryResponse
예산 월 가져오기
단일 예산 월을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
Month
|
month | True | date |
ISO 형식의 예산 월(예: 2016-12-01)입니다. ("current"를 사용하여 현재 달력 월(UTC)을 지정할 수도 있습니다.) |
반환
- 월 세부 정보 응답
- MonthDetailResponse
예산 월 가져오기
모든 예산 월을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 월 요약 응답
- MonthSummariesResponse
예약된 트랜잭션 가져오기
예약된 모든 트랜잭션을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 예약된 트랜잭션 응답
- ScheduledTransactionsResponse
트랜잭션 가져오기
예산 트랜잭션을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
이후 날짜
|
since_date | date |
지정된 경우 이 날짜 이후의 트랜잭션만 포함됩니다. 날짜는 ISO 형식이어야 합니다(예: 2016-12-30). |
|
|
유형
|
type | string |
지정된 경우 지정된 형식의 트랜잭션만 포함됩니다. "분류되지 않음" 및 "승인되지 않음"은 현재 지원됩니다. |
|
|
서버에 대한 마지막 지식
|
last_knowledge_of_server | integer |
시작 서버 지식입니다. 제공된 경우 이후 변경된 |
반환
- 트랜잭션 응답
- TransactionsResponse
트랜잭션 가져오기
지정된 예산에 대해 연결된 모든 계정에서 사용 가능한 트랜잭션을 가져옵니다. 연결된 계정을 사용하면 지정된 금융 기관에서 직접 트랜잭션을 가져올 수 있으며 이 엔드포인트는 해당 가져오기를 시작합니다. 이 엔드포인트에 요청을 보내는 것은 웹 애플리케이션의 각 계정에서 "가져오기"를 클릭하거나 모바일 애플리케이션에서 "새 트랜잭션" 배너를 탭하는 것과 같습니다. 이 엔드포인트에 대한 응답에는 가져온 트랜잭션 ID가 포함됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
반환
- 트랜잭션 가져오기 응답
- TransactionsImportResponse
트랜잭션 만들기
단일 트랜잭션 또는 여러 트랜잭션을 만듭니다. 개체가 포함된 transaction 본문을 제공하는 경우 단일 트랜잭션이 만들어지고 배열이 포함된 transactions 본문을 제공하는 경우 여러 트랜잭션이 만들어집니다. 예약된 트랜잭션은 이 엔드포인트에서 만들 수 없습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
계정 ID
|
account_id | True | string |
계정 식별자입니다. |
|
날짜
|
date | True | date |
ISO 형식의 트랜잭션 날짜(예: 2016-12-01)입니다. 이후 날짜(예약된 트랜잭션)는 허용되지 않습니다. 분할 트랜잭션 날짜는 변경할 수 없으며 다른 날짜가 제공되면 무시됩니다. |
|
금액
|
amount | True | integer |
트랜잭션 금액(밀리니트 형식)입니다. 분할 트랜잭션 금액은 변경할 수 없으며 다른 금액이 제공되면 무시됩니다. |
|
수취인 ID
|
payee_id | uuid |
트랜잭션에 대한 수취인입니다. 두 계정 간에 이체를 만들려면 대상 계정을 가리키는 계정 이체 수취인을 사용합니다. 계정 이체 수취인은 계정 리소스에서와 같이 |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
트랜잭션의 범주입니다. 분할 트랜잭션을 구성하려면 null을 |
|
|
메모
|
memo | string |
메모입니다. |
|
|
지워짐
|
cleared | string |
트랜잭션의 지워진 상태입니다. |
|
|
승인됨
|
approved | boolean |
트랜잭션이 승인되었는지 여부입니다. 제공되지 않으면 트랜잭션은 기본적으로 승인되지 않습니다. |
|
|
플래그 색
|
flag_color | string |
트랜잭션 플래그입니다. |
|
|
ID 가져오기
|
import_id | string |
지정된 경우 새 트랜잭션에 할당 |
|
|
금액
|
amount | True | integer |
밀리니트 형식의 하위 변환 양입니다. |
|
수취인 ID
|
payee_id | uuid |
하위 번역에 대한 수취인입니다. |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
하위 번역의 범주입니다. 신용 카드 결제 범주는 허용되지 않으며 제공된 경우 무시됩니다. |
|
|
메모
|
memo | string |
메모입니다. |
|
|
계정 ID
|
account_id | True | string |
계정 식별자입니다. |
|
날짜
|
date | True | date |
ISO 형식의 트랜잭션 날짜(예: 2016-12-01)입니다. 이후 날짜(예약된 트랜잭션)는 허용되지 않습니다. 분할 트랜잭션 날짜는 변경할 수 없으며 다른 날짜가 제공되면 무시됩니다. |
|
금액
|
amount | True | integer |
트랜잭션 금액(밀리니트 형식)입니다. 분할 트랜잭션 금액은 변경할 수 없으며 다른 금액이 제공되면 무시됩니다. |
|
수취인 ID
|
payee_id | uuid |
트랜잭션에 대한 수취인입니다. 두 계정 간에 이체를 만들려면 대상 계정을 가리키는 계정 이체 수취인을 사용합니다. 계정 이체 수취인은 계정 리소스에서와 같이 |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
트랜잭션의 범주입니다. 분할 트랜잭션을 구성하려면 null을 |
|
|
메모
|
memo | string |
메모입니다. |
|
|
지워짐
|
cleared | string |
트랜잭션의 지워진 상태입니다. |
|
|
승인됨
|
approved | boolean |
트랜잭션이 승인되었는지 여부입니다. 제공되지 않으면 트랜잭션은 기본적으로 승인되지 않습니다. |
|
|
플래그 색
|
flag_color | string |
트랜잭션 플래그입니다. |
|
|
ID 가져오기
|
import_id | string |
지정된 경우 새 트랜잭션에 할당 |
|
|
금액
|
amount | True | integer |
밀리니트 형식의 하위 변환 양입니다. |
|
수취인 ID
|
payee_id | uuid |
하위 번역에 대한 수취인입니다. |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
하위 번역의 범주입니다. 신용 카드 결제 범주는 허용되지 않으며 제공된 경우 무시됩니다. |
|
|
메모
|
memo | string |
메모입니다. |
반환
- 트랜잭션 응답 저장
- SaveTransactionsResponse
트랜잭션 업데이트
단일 트랜잭션을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
트랜잭션 ID
|
transaction_id | True | string |
트랜잭션의 식별자입니다. |
|
계정 ID
|
account_id | True | string |
계정 식별자입니다. |
|
날짜
|
date | True | date |
ISO 형식의 트랜잭션 날짜(예: 2016-12-01)입니다. 이후 날짜(예약된 트랜잭션)는 허용되지 않습니다. 분할 트랜잭션 날짜는 변경할 수 없으며 다른 날짜가 제공되면 무시됩니다. |
|
금액
|
amount | True | integer |
트랜잭션 금액(밀리니트 형식)입니다. 분할 트랜잭션 금액은 변경할 수 없으며 다른 금액이 제공되면 무시됩니다. |
|
수취인 ID
|
payee_id | uuid |
트랜잭션에 대한 수취인입니다. 두 계정 간에 이체를 만들려면 대상 계정을 가리키는 계정 이체 수취인을 사용합니다. 계정 이체 수취인은 계정 리소스에서와 같이 |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
트랜잭션의 범주입니다. 분할 트랜잭션을 구성하려면 null을 |
|
|
메모
|
memo | string |
메모입니다. |
|
|
지워짐
|
cleared | string |
트랜잭션의 지워진 상태입니다. |
|
|
승인됨
|
approved | boolean |
트랜잭션이 승인되었는지 여부입니다. 제공되지 않으면 트랜잭션은 기본적으로 승인되지 않습니다. |
|
|
플래그 색
|
flag_color | string |
트랜잭션 플래그입니다. |
|
|
ID 가져오기
|
import_id | string |
지정된 경우 새 트랜잭션에 할당 |
|
|
금액
|
amount | True | integer |
밀리니트 형식의 하위 변환 양입니다. |
|
수취인 ID
|
payee_id | uuid |
하위 번역에 대한 수취인입니다. |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
하위 번역의 범주입니다. 신용 카드 결제 범주는 허용되지 않으며 제공된 경우 무시됩니다. |
|
|
메모
|
memo | string |
메모입니다. |
반환
- 트랜잭션 응답
- TransactionResponse
트랜잭션 업데이트
여러 트랜잭션을 업데이트합니다( 또는 idimport_id.).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
예산 ID
|
budget_id | True | string |
예산의 식별자입니다. "마지막 사용"은 마지막으로 사용한 예산을 지정하는 데 사용할 수 있으며 기본 예산 선택을 사용하는 경우 "기본값"을 사용할 수 있습니다(참조: https://api.youneedabudget.com/#oauth-default-budget). |
|
아이디
|
id | True | string |
식별자입니다. |
|
계정 ID
|
account_id | True | string |
계정 식별자입니다. |
|
날짜
|
date | True | date |
ISO 형식의 트랜잭션 날짜(예: 2016-12-01)입니다. 이후 날짜(예약된 트랜잭션)는 허용되지 않습니다. 분할 트랜잭션 날짜는 변경할 수 없으며 다른 날짜가 제공되면 무시됩니다. |
|
금액
|
amount | True | integer |
트랜잭션 금액(밀리니트 형식)입니다. 분할 트랜잭션 금액은 변경할 수 없으며 다른 금액이 제공되면 무시됩니다. |
|
수취인 ID
|
payee_id | uuid |
트랜잭션에 대한 수취인입니다. 두 계정 간에 이체를 만들려면 대상 계정을 가리키는 계정 이체 수취인을 사용합니다. 계정 이체 수취인은 계정 리소스에서와 같이 |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
트랜잭션의 범주입니다. 분할 트랜잭션을 구성하려면 null을 |
|
|
메모
|
memo | string |
메모입니다. |
|
|
지워짐
|
cleared | string |
트랜잭션의 지워진 상태입니다. |
|
|
승인됨
|
approved | boolean |
트랜잭션이 승인되었는지 여부입니다. 제공되지 않으면 트랜잭션은 기본적으로 승인되지 않습니다. |
|
|
플래그 색
|
flag_color | string |
트랜잭션 플래그입니다. |
|
|
ID 가져오기
|
import_id | string |
지정된 경우 새 트랜잭션에 할당 |
|
|
금액
|
amount | True | integer |
밀리니트 형식의 하위 변환 양입니다. |
|
수취인 ID
|
payee_id | uuid |
하위 번역에 대한 수취인입니다. |
|
|
수취인
|
payee_name | string |
수취인 이름입니다.
|
|
|
범주 ID
|
category_id | uuid |
하위 번역의 범주입니다. 신용 카드 결제 범주는 허용되지 않으며 제공된 경우 무시됩니다. |
|
|
메모
|
memo | string |
메모입니다. |
반환
- 트랜잭션 응답 저장
- SaveTransactionsResponse
정의
UserResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | Data |
사용자
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
DateFormat
예산의 날짜 형식 설정입니다. 경우에 따라 형식을 사용할 수 없으며 null로 지정됩니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
포맷
|
format | string |
형식입니다. |
CurrencyFormat
예산에 대한 통화 형식 설정입니다. 경우에 따라 형식을 사용할 수 없으며 null로 지정됩니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
ISO 코드
|
iso_code | string |
ISO 코드입니다. |
|
예제 형식
|
example_format | string |
예제 형식입니다. |
|
소수 자릿수
|
decimal_digits | integer |
10진수입니다. |
|
10진수 구분 기호
|
decimal_separator | string |
소수 구분 기호입니다. |
|
기호 우선
|
symbol_first | boolean |
기호가 첫 번째인지 여부입니다. |
|
그룹 구분 기호
|
group_separator | string |
그룹 구분 기호입니다. |
|
통화 기호
|
currency_symbol | string |
통화 기호입니다. |
|
표시된 기호
|
display_symbol | boolean |
기호가 표시되는지 여부입니다. |
BudgetSummaryResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data1
|
data | Data1 |
BudgetSummary
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
이름
|
name | string |
이름입니다. |
|
마지막으로 수정한 날짜
|
last_modified_on | date-time |
웹 또는 모바일 클라이언트에서 예산을 마지막으로 변경한 시간입니다. |
|
첫 달
|
first_month | date |
가장 빠른 예산 월입니다. |
|
지난 달
|
last_month | date |
최신 예산 월입니다. |
|
날짜 형식
|
date_format | DateFormat |
예산의 날짜 형식 설정입니다. 경우에 따라 형식을 사용할 수 없으며 null로 지정됩니다. |
|
통화 형식
|
currency_format | CurrencyFormat |
예산에 대한 통화 형식 설정입니다. 경우에 따라 형식을 사용할 수 없으며 null로 지정됩니다. |
|
Accounts
|
accounts | array of Account |
예산 계정(쿼리 매개 변수로 지정된 경우에만 |
BudgetDetailResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data2
|
data | Data2 |
BudgetDetail
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
이름
|
name | string |
이름입니다. |
|
마지막으로 수정한 날짜
|
last_modified_on | date-time |
웹 또는 모바일 클라이언트에서 예산을 마지막으로 변경한 시간입니다. |
|
첫 달
|
first_month | date |
가장 빠른 예산 월입니다. |
|
지난 달
|
last_month | date |
최신 예산 월입니다. |
|
날짜 형식
|
date_format | DateFormat |
예산의 날짜 형식 설정입니다. 경우에 따라 형식을 사용할 수 없으며 null로 지정됩니다. |
|
통화 형식
|
currency_format | CurrencyFormat |
예산에 대한 통화 형식 설정입니다. 경우에 따라 형식을 사용할 수 없으며 null로 지정됩니다. |
|
Accounts
|
accounts | array of Account |
예산 계정(쿼리 매개 변수로 지정된 경우에만 |
|
수취인
|
payees | array of Payee | |
|
수취인 위치
|
payee_locations | array of PayeeLocation | |
|
범주 그룹
|
category_groups | array of CategoryGroup | |
|
카테고리
|
categories | array of Category | |
|
달
|
months | array of MonthDetail | |
|
Transactions
|
transactions | array of TransactionSummary | |
|
하위 번역
|
subtransactions | array of SubTransaction | |
|
예약된 트랜잭션
|
scheduled_transactions | array of ScheduledTransactionSummary | |
|
예약된 하위 번역
|
scheduled_subtransactions | array of ScheduledSubTransaction |
BudgetSettingsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data3
|
data | Data3 |
BudgetSettings
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
날짜 형식
|
date_format | DateFormat |
예산의 날짜 형식 설정입니다. 경우에 따라 형식을 사용할 수 없으며 null로 지정됩니다. |
|
통화 형식
|
currency_format | CurrencyFormat |
예산에 대한 통화 형식 설정입니다. 경우에 따라 형식을 사용할 수 없으며 null로 지정됩니다. |
AccountsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data4
|
data | Data4 |
AccountResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data5
|
data | Data5 |
어카운트
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
이름
|
name | string |
이름입니다. |
|
유형
|
type | Type |
계정 유형입니다. 참고: PayPal, merchantAccount, investmentAccount 및 모기지 유형은 더 이상 사용되지 않으며 향후 제거될 예정입니다. |
|
예산
|
on_budget | boolean |
이 계정이 예산에 있는지 여부 |
|
닫힘
|
closed | boolean |
이 계정이 닫혔는지 여부 |
|
비고
|
note | string |
참고입니다. |
|
저울
|
balance | integer |
계정의 현재 잔액(밀리니트 형식)입니다. |
|
지워진 잔액
|
cleared_balance | integer |
계정의 현재 지워진 잔액(밀리니트 형식)입니다. |
|
명확하지 않은 잔액
|
uncleared_balance | integer |
계정의 현재 명확하지 않은 잔액(밀리니트 형식)입니다. |
|
수취인 ID 이전
|
transfer_payee_id | string |
이 계정으로 전송할 때 사용해야 하는 수취인 식별자입니다. |
|
직접 가져오기 연결
|
direct_import_linked | boolean |
계정이 자동 트랜잭션 가져오기를 위해 금융 기관에 연결되어 있는지 여부입니다. |
|
직접 가져오기 오류
|
direct_import_in_error | boolean |
금융 기관에 연결된 계정(direct_import_linked=true)이고 연결된 연결이 정상 상태가 아닌 경우 이는 사실입니다. |
|
삭제됨
|
deleted | boolean |
계정이 삭제되었는지 여부입니다. 삭제된 계정은 델타 요청에만 포함됩니다. |
CategoriesResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data6
|
data | Data6 |
CategoryResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data7
|
data | Data7 |
CategoryGroupWithCategories
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
이름
|
name | string |
이름입니다. |
|
숨겨져 있음
|
hidden | boolean |
범주 그룹을 숨길지 여부입니다. |
|
삭제됨
|
deleted | boolean |
범주 그룹이 삭제되었는지 여부입니다. 삭제된 범주 그룹은 델타 요청에만 포함됩니다. |
|
카타고리스 (주)
|
categories | array of Category |
범주 그룹 범주입니다. 금액(예산, 활동, 잔액 등)은 현재 예산 월(UTC)과 관련이 있습니다. |
CategoryGroup
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
이름
|
name | string |
이름입니다. |
|
숨겨져 있음
|
hidden | boolean |
범주 그룹을 숨길지 여부입니다. |
|
삭제됨
|
deleted | boolean |
범주 그룹이 삭제되었는지 여부입니다. 삭제된 범주 그룹은 델타 요청에만 포함됩니다. |
카테고리
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
범주 그룹 ID
|
category_group_id | string |
범주 그룹 식별자입니다. |
|
이름
|
name | string |
이름입니다. |
|
숨겨져 있음
|
hidden | boolean |
범주가 숨겨지는지 여부입니다. |
|
원래 범주 그룹 ID
|
original_category_group_id | uuid |
범주가 숨겨진 경우 원래 범주 그룹이 숨겨지기 전에 속했던 범주 그룹의 식별자입니다. |
|
비고
|
note | string |
참고입니다. |
|
예산
|
budgeted | integer |
예산 금액(밀리니트 형식)입니다. |
|
Activity
|
activity | integer |
활동량(밀리니트 형식)입니다. |
|
저울
|
balance | integer |
밀리니트 형식으로 균형을 조정합니다. |
|
목표 유형
|
goal_type | GoalType |
범주에 목표가 있는 경우 목표 유형(TB='대상 범주 잔액', TBD='날짜별 대상 범주 잔액', MF='월간 자금 조달', NEED='지출 계획') |
|
목표 생성 월
|
goal_creation_month | date |
목표를 만든 달입니다. |
|
목표 목표
|
goal_target | integer |
목표 목표 금액(밀리니트)입니다. |
|
목표 목표 월
|
goal_target_month | date |
목표를 완료할 원래 대상 월입니다. 일부 목표 유형만 이 날짜를 지정합니다. |
|
목표 백분율 완료
|
goal_percentage_complete | integer |
목표 완료율입니다. |
|
목표 월-예산
|
goal_months_to_budget | integer |
현재 목표 기간에 남은 월(현재 월 포함)입니다. |
|
자금 지원 아래의 목표
|
goal_under_funded | integer |
현재 목표 기간 내에 목표를 달성하기 위해 현재 달에 여전히 필요한 자금의 양입니다. 이 금액은 일반적으로 향후 달에 지출 목표가 필요한 범주를 볼 때를 제외하고 웹 및 모바일 클라이언트의 '자금 부족' 금액에 해당합니다. 웹 및 모바일 클라이언트는 향후 한 달 동안 지출 목표가 필요한 범주를 볼 때 이전 목표 기간의 자금을 무시합니다. |
|
전체 자금 조달 목표
|
goal_overall_funded | integer |
현재 목표 기간 내에 목표를 향해 자금을 조달한 총 금액입니다. |
|
골 전체 왼쪽
|
goal_overall_left | integer |
현재 목표 기간 내에 목표를 완료하는 데 필요한 자금의 양입니다. |
|
삭제됨
|
deleted | boolean |
범주가 삭제되었는지 여부입니다. 삭제된 범주는 델타 요청에만 포함됩니다. |
SaveCategoryResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data8
|
data | Data8 |
PayeesResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data9
|
data | Data9 |
PayeeResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data10
|
data | Data10 |
수취인
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
이름
|
name | string |
이름입니다. |
|
계정 ID 전송
|
transfer_account_id | string |
이체 수취인 |
|
삭제됨
|
deleted | boolean |
수취인을 삭제했는지 여부입니다. 삭제된 수취인은 델타 요청에만 포함됩니다. |
PayeeLocationsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data11
|
data | Data11 |
PayeeLocationResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data12
|
data | Data12 |
PayeeLocation
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
수취인 ID
|
payee_id | string |
수취인 식별자입니다. |
|
위도
|
latitude | string |
위도입니다. |
|
경도
|
longitude | string |
경도입니다. |
|
삭제됨
|
deleted | boolean |
수취인 위치가 삭제되었는지 여부입니다. 삭제된 수취인 위치는 델타 요청에만 포함됩니다. |
TransactionsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data13
|
data | Data13 |
HybridTransactionsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data14
|
data | Data14 |
SaveTransactionsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data15
|
data | Data15 |
TransactionResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data16
|
data | Data16 |
TransactionSummary
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
날짜
|
date | date |
ISO 형식의 트랜잭션 날짜(예: 2016-12-01)입니다. |
|
금액
|
amount | integer |
트랜잭션 금액(밀리니트 형식)입니다. |
|
메모
|
memo | string |
메모입니다. |
|
지워짐
|
cleared | Cleared |
트랜잭션의 지워진 상태입니다. |
|
승인됨
|
approved | boolean |
트랜잭션이 승인되었는지 여부입니다. |
|
플래그 색
|
flag_color | FlagColor |
트랜잭션 플래그입니다. |
|
계정 ID
|
account_id | string |
계정 식별자입니다. |
|
수취인 ID
|
payee_id | string |
수취인 식별자입니다. |
|
범주 ID
|
category_id | string |
범주 식별자입니다. |
|
계정 ID 전송
|
transfer_account_id | uuid |
전송 트랜잭션인 경우 전송되는 계정입니다. |
|
트랜잭션 ID 전송
|
transfer_transaction_id | string |
전송 트랜잭션인 경우 전송의 다른 쪽에 있는 트랜잭션의 식별자입니다. |
|
일치하는 트랜잭션 ID
|
matched_transaction_id | string |
트랜잭션이 일치하면 일치하는 트랜잭션의 식별자입니다. |
|
ID 가져오기
|
import_id | string |
트랜잭션을 가져온 경우 이 필드는 고유한(계정별) 가져오기 식별자입니다. 이 트랜잭션을 API를 통하지 않고 파일 기반 가져오기 또는 직접 가져오기를 통해 가져온 경우 import_id 'YNAB:[milliunit_amount]:[iso_date]:[occurrence]' 형식을 갖습니다. 예를 들어 -$294.23 USD의 2015-12-30 일자 트랜잭션에는 'YNAB:-294230:2015-12-30:1'의 import_id 있습니다. 동일한 계정의 두 번째 트랜잭션을 가져와서 동일한 날짜와 금액이 있는 경우 해당 import_id 'YNAB:-294230:2015-12-30:2'가 됩니다. |
|
삭제됨
|
deleted | boolean |
트랜잭션이 삭제되었는지 여부입니다. 삭제된 트랜잭션은 델타 요청에만 포함됩니다. |
TransactionDetail
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
날짜
|
date | date |
ISO 형식의 트랜잭션 날짜(예: 2016-12-01)입니다. |
|
금액
|
amount | integer |
트랜잭션 금액(밀리니트 형식)입니다. |
|
메모
|
memo | string |
메모입니다. |
|
지워짐
|
cleared | Cleared |
트랜잭션의 지워진 상태입니다. |
|
승인됨
|
approved | boolean |
트랜잭션이 승인되었는지 여부입니다. |
|
플래그 색
|
flag_color | FlagColor |
트랜잭션 플래그입니다. |
|
계정 ID
|
account_id | string |
계정 식별자입니다. |
|
수취인 ID
|
payee_id | string |
수취인 식별자입니다. |
|
범주 ID
|
category_id | string |
범주 식별자입니다. |
|
계정 ID 전송
|
transfer_account_id | uuid |
전송 트랜잭션인 경우 전송되는 계정입니다. |
|
트랜잭션 ID 전송
|
transfer_transaction_id | string |
전송 트랜잭션인 경우 전송의 다른 쪽에 있는 트랜잭션의 식별자입니다. |
|
일치하는 트랜잭션 ID
|
matched_transaction_id | string |
트랜잭션이 일치하면 일치하는 트랜잭션의 식별자입니다. |
|
ID 가져오기
|
import_id | string |
트랜잭션을 가져온 경우 이 필드는 고유한(계정별) 가져오기 식별자입니다. 이 트랜잭션을 API를 통하지 않고 파일 기반 가져오기 또는 직접 가져오기를 통해 가져온 경우 import_id 'YNAB:[milliunit_amount]:[iso_date]:[occurrence]' 형식을 갖습니다. 예를 들어 -$294.23 USD의 2015-12-30 일자 트랜잭션에는 'YNAB:-294230:2015-12-30:1'의 import_id 있습니다. 동일한 계정의 두 번째 트랜잭션을 가져와서 동일한 날짜와 금액이 있는 경우 해당 import_id 'YNAB:-294230:2015-12-30:2'가 됩니다. |
|
삭제됨
|
deleted | boolean |
트랜잭션이 삭제되었는지 여부입니다. 삭제된 트랜잭션은 델타 요청에만 포함됩니다. |
|
어카운트 이름
|
account_name | string |
계정 이름입니다. |
|
수취인
|
payee_name | string |
수취인 이름입니다. |
|
카테고리
|
category_name | string |
범주 이름입니다. |
|
하위 번역
|
subtransactions | array of SubTransaction |
분할 트랜잭션인 경우 하위 트랜잭션이 실행됩니다. |
HybridTransaction
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
날짜
|
date | date |
ISO 형식의 트랜잭션 날짜(예: 2016-12-01)입니다. |
|
금액
|
amount | integer |
트랜잭션 금액(밀리니트 형식)입니다. |
|
메모
|
memo | string |
메모입니다. |
|
지워짐
|
cleared | Cleared |
트랜잭션의 지워진 상태입니다. |
|
승인됨
|
approved | boolean |
트랜잭션이 승인되었는지 여부입니다. |
|
플래그 색
|
flag_color | FlagColor |
트랜잭션 플래그입니다. |
|
계정 ID
|
account_id | string |
계정 식별자입니다. |
|
수취인 ID
|
payee_id | string |
수취인 식별자입니다. |
|
범주 ID
|
category_id | string |
범주 식별자입니다. |
|
계정 ID 전송
|
transfer_account_id | uuid |
전송 트랜잭션인 경우 전송되는 계정입니다. |
|
트랜잭션 ID 전송
|
transfer_transaction_id | string |
전송 트랜잭션인 경우 전송의 다른 쪽에 있는 트랜잭션의 식별자입니다. |
|
일치하는 트랜잭션 ID
|
matched_transaction_id | string |
트랜잭션이 일치하면 일치하는 트랜잭션의 식별자입니다. |
|
ID 가져오기
|
import_id | string |
트랜잭션을 가져온 경우 이 필드는 고유한(계정별) 가져오기 식별자입니다. 이 트랜잭션을 API를 통하지 않고 파일 기반 가져오기 또는 직접 가져오기를 통해 가져온 경우 import_id 'YNAB:[milliunit_amount]:[iso_date]:[occurrence]' 형식을 갖습니다. 예를 들어 -$294.23 USD의 2015-12-30 일자 트랜잭션에는 'YNAB:-294230:2015-12-30:1'의 import_id 있습니다. 동일한 계정의 두 번째 트랜잭션을 가져와서 동일한 날짜와 금액이 있는 경우 해당 import_id 'YNAB:-294230:2015-12-30:2'가 됩니다. |
|
삭제됨
|
deleted | boolean |
트랜잭션이 삭제되었는지 여부입니다. 삭제된 트랜잭션은 델타 요청에만 포함됩니다. |
|
Type3
|
type | Type3 |
하이브리드 트랜잭션이 일반 트랜잭션 또는 하위 트랜잭션을 나타내는지 여부 |
|
부모 트랜잭션 ID
|
parent_transaction_id | string |
하위 트랜잭션 형식의 경우 부모 트랜잭션의 식별자입니다. 트랜잭션 형식의 경우 이 식별자는 항상 null입니다. |
|
어카운트 이름
|
account_name | string |
계정 이름입니다. |
|
수취인
|
payee_name | string |
수취인 이름입니다. |
|
카테고리
|
category_name | string |
범주 이름입니다. |
TransactionsImportResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data17
|
data | Data17 |
BulkResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data18
|
data | Data18 |
하위 번역
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
트랜잭션 ID
|
transaction_id | string |
트랜잭션입니다. |
|
금액
|
amount | integer |
밀리니트 형식의 하위 변환 양입니다. |
|
메모
|
memo | string |
메모입니다. |
|
수취인 ID
|
payee_id | string |
수취인 식별자입니다. |
|
수취인
|
payee_name | string |
수취인 이름입니다. |
|
범주 ID
|
category_id | string |
범주 식별자입니다. |
|
카테고리
|
category_name | string |
범주 이름입니다. |
|
계정 ID 전송
|
transfer_account_id | uuid |
전송하는 경우 하위 트랜스랜잭션이 전송되는 account_id. |
|
트랜잭션 ID 전송
|
transfer_transaction_id | string |
전송하는 경우 전송의 다른 쪽에 있는 트랜잭션의 식별자입니다. |
|
삭제됨
|
deleted | boolean |
하위 작업이 삭제되었는지 여부입니다. 삭제된 하위 작업은 델타 요청에만 포함됩니다. |
ScheduledTransactionsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data19
|
data | Data19 |
ScheduledTransactionResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data20
|
data | Data20 |
ScheduledTransactionSummary
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
첫 번째 날짜
|
date_first | date |
예약된 트랜잭션이 예약된 첫 번째 날짜입니다. |
|
다음 날짜
|
date_next | date |
예약된 트랜잭션이 예약된 다음 날짜입니다. |
|
빈도
|
frequency | Frequency |
빈도입니다. |
|
금액
|
amount | integer |
예약된 트랜잭션 금액(밀리니트 형식)입니다. |
|
메모
|
memo | string |
메모입니다. |
|
FlagColor1
|
flag_color | FlagColor1 |
예약된 트랜잭션 플래그입니다. |
|
계정 ID
|
account_id | string |
계정 식별자입니다. |
|
수취인 ID
|
payee_id | string |
수취인 식별자입니다. |
|
범주 ID
|
category_id | string |
범주 식별자입니다. |
|
계정 ID 전송
|
transfer_account_id | uuid |
전송하는 경우 예약된 트랜잭션이 전송되는 account_id. |
|
삭제됨
|
deleted | boolean |
예약된 트랜잭션이 삭제되었는지 여부입니다. 삭제된 예약된 트랜잭션은 델타 요청에만 포함됩니다. |
ScheduledTransactionDetail
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
첫 번째 날짜
|
date_first | date |
예약된 트랜잭션이 예약된 첫 번째 날짜입니다. |
|
다음 날짜
|
date_next | date |
예약된 트랜잭션이 예약된 다음 날짜입니다. |
|
빈도
|
frequency | Frequency |
빈도입니다. |
|
금액
|
amount | integer |
예약된 트랜잭션 금액(밀리니트 형식)입니다. |
|
메모
|
memo | string |
메모입니다. |
|
FlagColor1
|
flag_color | FlagColor1 |
예약된 트랜잭션 플래그입니다. |
|
계정 ID
|
account_id | string |
계정 식별자입니다. |
|
수취인 ID
|
payee_id | string |
수취인 식별자입니다. |
|
범주 ID
|
category_id | string |
범주 식별자입니다. |
|
계정 ID 전송
|
transfer_account_id | uuid |
전송하는 경우 예약된 트랜잭션이 전송되는 account_id. |
|
삭제됨
|
deleted | boolean |
예약된 트랜잭션이 삭제되었는지 여부입니다. 삭제된 예약된 트랜잭션은 델타 요청에만 포함됩니다. |
|
어카운트 이름
|
account_name | string |
계정 이름입니다. |
|
수취인
|
payee_name | string |
수취인 이름입니다. |
|
카테고리
|
category_name | string |
범주 이름입니다. |
|
하위 번역
|
subtransactions | array of ScheduledSubTransaction |
예약된 트랜잭션을 분할하는 경우 하위 트랜잭션이 실행됩니다. |
ScheduledSubTransaction
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
예약된 트랜잭션 ID
|
scheduled_transaction_id | string |
예약된 트랜잭션 식별자입니다. |
|
금액
|
amount | integer |
예약된 하위 변환 양(밀리니트 형식)입니다. |
|
메모
|
memo | string |
메모입니다. |
|
수취인 ID
|
payee_id | string |
수취인 식별자입니다. |
|
범주 ID
|
category_id | string |
범주 식별자입니다. |
|
계정 ID 전송
|
transfer_account_id | uuid |
전송하는 경우 예약된 하위 실행이 전송되는 account_id. |
|
삭제됨
|
deleted | boolean |
예약된 하위 작업이 삭제되었는지 여부입니다. 삭제된 예약된 하위 작업은 델타 요청에만 포함됩니다. |
MonthSummariesResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data21
|
data | Data21 |
MonthDetailResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Data22
|
data | Data22 |
MonthSummary
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Month
|
month | date |
월입니다. |
|
비고
|
note | string |
참고입니다. |
|
소득
|
income | integer |
월에 '유입: 할당 준비 완료'로 분류된 총 트랜잭션 양입니다. |
|
예산
|
budgeted | integer |
해당 월의 총 예산 금액입니다. |
|
Activity
|
activity | integer |
'유입: 할당 준비 완료'로 분류된 트랜잭션을 제외한 월의 총 트랜잭션 양입니다. |
|
예산을 책정하려면
|
to_be_budgeted | integer |
'할당 준비 완료'에 사용할 수 있는 금액입니다. |
|
돈의 나이
|
age_of_money | integer |
월 현재 돈의 나이. |
|
삭제됨
|
deleted | boolean |
월이 삭제되었는지 여부입니다. 삭제된 월은 델타 요청에만 포함됩니다. |
MonthDetail
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Month
|
month | date |
월입니다. |
|
비고
|
note | string |
참고입니다. |
|
소득
|
income | integer |
월에 '유입: 할당 준비 완료'로 분류된 총 트랜잭션 양입니다. |
|
예산
|
budgeted | integer |
해당 월의 총 예산 금액입니다. |
|
Activity
|
activity | integer |
'유입: 할당 준비 완료'로 분류된 트랜잭션을 제외한 월의 총 트랜잭션 양입니다. |
|
예산을 책정하려면
|
to_be_budgeted | integer |
'할당 준비 완료'에 사용할 수 있는 금액입니다. |
|
돈의 나이
|
age_of_money | integer |
월 현재 돈의 나이. |
|
삭제됨
|
deleted | boolean |
월이 삭제되었는지 여부입니다. 삭제된 월은 델타 요청에만 포함됩니다. |
|
카테고리
|
categories | array of Category |
예산 월 범주입니다. 금액(예산, 활동, 잔액 등)은 지정된 {month} 매개 변수와 관련이 있습니다. |
대량
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
트랜잭션 ID
|
transaction_ids | array of string |
생성된 트랜잭션 ID 목록입니다. |
|
중복 가져오기 ID
|
duplicate_import_ids | array of string |
동일한 계정에 이미 일치하는 트랜잭션이 있었기 |
지워짐
데이터
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자
|
user | User |
Data1
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
예산
|
budgets | array of BudgetSummary | |
|
예산 요약
|
default_budget | BudgetSummary |
Data2
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
예산 세부 정보
|
budget | BudgetDetail | |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data3
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
예산 설정
|
settings | BudgetSettings |
Data4
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Accounts
|
accounts | array of Account | |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data5
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
어카운트
|
account | Account |
Data6
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
범주 그룹
|
category_groups | array of CategoryGroupWithCategories |
범주 그룹입니다. |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data7
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
카테고리
|
category | Category |
Data8
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
카테고리
|
category | Category | |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data9
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수취인
|
payees | array of Payee |
수취인. |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data10
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수취인
|
payee | Payee |
Data11
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수취인 위치
|
payee_locations | array of PayeeLocation |
수취인 위치입니다. |
Data12
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수신자 위치
|
payee_location | PayeeLocation |
Data13
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Transactions
|
transactions | array of TransactionDetail |
트랜잭션입니다. |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data14
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Transactions
|
transactions | array of HybridTransaction |
트랜잭션입니다. |
Data15
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
트랜잭션 ID
|
transaction_ids | array of string |
저장된 트랜잭션 ID입니다. |
|
트랜잭션 세부 정보
|
transaction | TransactionDetail | |
|
트랜잭션
|
transactions | array of TransactionDetail |
여러 트랜잭션이 지정된 경우 저장된 트랜잭션입니다. |
|
중복 가져오기 ID
|
duplicate_import_ids | array of string |
여러 트랜잭션이 지정된 경우 동일한 계정에 있는 기존 |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data16
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
트랜잭션 세부 정보
|
transaction | TransactionDetail |
Data17
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
트랜잭션 ID
|
transaction_ids | array of string |
가져온 트랜잭션 ID 목록입니다. |
Data18
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
대량
|
bulk | Bulk |
Data19
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
scheduled_transactions
|
scheduled_transactions | array of ScheduledTransactionDetail | |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data20
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
예약된 트랜잭션 세부 정보
|
scheduled_transaction | ScheduledTransactionDetail |
Data21
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
개월
|
months | array of MonthSummary | |
|
서버 지식
|
server_knowledge | integer |
서버에 대한 지식입니다. |
Data22
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
월 세부 정보
|
month | MonthDetail |
FlagColor
FlagColor1
빈도
GoalType
범주에 목표가 있는 경우 목표 유형(TB='대상 범주 잔액', TBD='날짜별 대상 범주 잔액', MF='월간 자금 조달', NEED='지출 계획')
범주에 목표가 있는 경우 목표 유형(TB='대상 범주 잔액', TBD='날짜별 대상 범주 잔액', MF='월간 자금 조달', NEED='지출 계획')
- 목표 유형
- string
유형
계정 유형입니다. 참고: PayPal, merchantAccount, investmentAccount 및 모기지 유형은 더 이상 사용되지 않으며 향후 제거될 예정입니다.
계정 유형입니다. 참고: PayPal, merchantAccount, investmentAccount 및 모기지 유형은 더 이상 사용되지 않으며 향후 제거될 예정입니다.
- 유형
- string