해외 송금 일괄 배치 상세 조회
batchId 의 배치를 조회합니다.
해외 송금 일괄 배치 상세 조회 API는 GET 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.
| HTTP URL | /api/oris/v1/batches/{batchId} |
|---|---|
| HTTP Method | GET |
| HTTP | 항목 | TYPE(길이) | 필수 | 값 | 설명 |
|---|---|---|---|---|---|
| Header | Authorization | string | Y | Bearer <access_token> | 로그인 시 ORIS로부터 전송받은 access_token을 HTTP Header에 추가 [scope = inquiry] |
| Parameter | [inpath] batchId | string | Y | 01K6HZSF7509N9S8EPTQ7X1FXS | 생성된 배치 ID |
| HTTP | 항목 | TYPE(길이) | 필수 | 값 | 설명 |
|---|---|---|---|---|---|
| Body | batchId | string | Y | 01K0S9JDCA41ZTTTTQT380KR13 | 배치 ID |
| agencyId | string | Y | 01K0S9JDCA41ZTTTTQT380KR13 | 참가기관 ID | |
| status | string | Y | PROCESSING | 배치 상태 | |
| batchType | string | Y | REMITTANCE | 배치 유형 | |
| expectedRows | integer(int64) | Y | 10000 | 예정 행 수 | |
| progress | object | Y | - | 진행 상황 | |
| progress.received | integer(int64) | Y | 2500 | 수신된 행 수 | |
| progress.validated | integer(int64) | Y | 2400 | 유효성 검사 통과 행 수 | |
| progress.merged | integer(int64) | Y | 2000 | 병합된 행 수 | |
| progress.errors | integer(int64) | Y | 10 | 오류 행 수 | |
| chunks[] | array<object> | Y | - | 청크 목록 | |
| chunks[].seq | integer(int32) | Y | 0 | 청크 순서 | |
| chunks[].uploadType | string | Y | JSON | 업로드 타입 | |
| chunks[].status | string | Y | COMPLETED | 청크 상태 | |
| chunks[].rowCountDeclared | integer(int32) | Y | 1000 | 선언된 행 수 | |
| chunks[].rowCountReceived | integer(int32) | Y | 1000 | 수신된 행 수 | |
| chunks[].fileName | string | N | 0.api.v1.json.gz | 파일명 | |
| chunks[].fileSize | integer(int64) | N | 1048576 | 파일 크기 (bytes) | |
| chunks[].sha256 | string | N | 65cd5a6ab84f04388f33c6c5557edf47883cf4fa927b002016d8b0220fcc6867 | SHA-256 해시 | |
| chunks[].createdAt | string | N | 2025-10-07T11:25:00Z | 생성 일시 | |
| limits | object | Y | - | 배치 업로드 한도 | |
| limits.maxChunkRows | integer(int32) | Y | 1000 | 청크당 최대 행 수 | |
| limits.maxChunkBytes | integer(int64) | Y | 10485760 | 청크당 최대 바이트 수 | |
| limits.maxInFlightChunks | integer(int32) | Y | 3 | 동시 처리 가능한 최대 청크 수 | |
| createdAt | string | Y | 2025-10-07T11:20:00Z | 생성 일시 | |
| executeRequestedAt | string | N | 2025-10-07T11:30:00Z | 실행 요청 일시 | |
| executedAt | string | N | 2025-10-07T11:45:30Z | 실행 완료 일시 |
{
"batchId": "01K0S9JDCA41ZTTTTQT380KR13",
"agencyId": "01K0S9JDCA41ZTTTTQT380KR13",
"status": "PROCESSING",
"batchType": "REMITTANCE",
"expectedRows": 10000,
"progress": {
"received": 2500,
"validated": 2400,
"merged": 2000,
"errors": 10
},
"chunks": [
{
"seq": 1073741824,
"uploadType": "JSON",
"status": "COMPLETED",
"rowCountDeclared": 1000,
"rowCountReceived": 1000,
"fileName": "0.api.v1.json.gz",
"fileSize": 1048576,
"sha256": "65cd5a6ab84f04388f33c6c5557edf47883cf4fa927b002016d8b0220fcc6867",
"createdAt": "2025-10-07T11:25:00Z"
}
],
"limits": {
"maxChunkRows": 1000,
"maxChunkBytes": 10485760,
"maxInFlightChunks": 3
},
"createdAt": "2025-10-07T11:20:00Z",
"executeRequestedAt": "2025-10-07T11:30:00Z",
"executedAt": "2025-10-07T11:45:30Z"
}| HTTP | 항목 | TYPE(길이) | 필수 | 값 | 설명 |
|---|---|---|---|---|---|
| Body | message | string | N | 요청에 실패했습니다. | 오류 메시지 |
| code | string("ERROR" | "BAD_REQUEST" | "INVALID_REQUEST" | "UNAUTHORIZED" | "FORBIDDEN" | "ACCESS_TOKEN_REQUIRED" | "ACCESS_TOKEN_EXPIRED" | "ACCESS_TOKEN_INVALID" | "ACCESS_TOKEN_NOT_ENOUGH_PERMISSION" | "AGENCY_NOT_FOUND" | "AGENCY_NOT_ACTIVE" | "AGENCY_NOT_APPROVED" | "AGENCY_NOT_MATCH" | "AGENCY_ACCESS_DENIED" | "AGENCY_CODE_DUPLICATED" | "MEMBER_NOT_FOUND" | "MEMBER_NOT_ACTIVE" | "MEMBER_NOT_MATCH" | "MEMBER_PASSWORD_NOT_MATCH" | "MEMBER_EMAIL_DUPLICATED" | "MEMBER_PASSWORD_RESET" | "MEMBER_PASSWORD_RESET_WITH_OLD" | "MEMBER_PASSWORD_INVALID_FORMAT" | "MEMBER_PASSWORD_FAIL_LIMIT_EXCEEDED" | "MEMBER_PASSWORD_EXPIRED" | "MEMBER_ACCOUNT_LOCKED" | "MEMBER_PASSWORD_REUSED" | "MEMBER_ACCESS_DENIED" | "API_KEY_NOT_FOUND" | "USER_NOT_FOUND" | "USER_NOT_ACTIVE" | "ACCOUNT_NOT_FOUND" | "REMITTANCE_NOT_FOUND" | "REMITTANCE_ALREADY_EXISTS" | "REMITTANCE_ALREADY_CANCELED" | "REMITTANCE_ACCOUNT_YEAR_MISMATCH" | "THREAD_NOT_FOUND" | "THREAD_ACCESS_DENIED" | "POST_NOT_FOUND" | "POST_ACCESS_DENIED" | "COMMENT_NOT_FOUND" | "COMMENT_ACCESS_DENIED" | "FILE_NOT_FOUND" | "FILE_ACCESS_DENIED" | "FILE_ALREADY_ATTACHED" | "FILE_DELETE_FAILED" | "TERM_NOT_FOUND" | "TERM_CANNOT_UPDATE" | "TERM_CANNOT_DELETE" | "TERM_CANNOT_SET_INITIATION_DATE" | "TERM_CANNOT_WITHDRAW_INITIATION_DATE" | "TERM_TYPE_NOT_FOUND" | "CONSENT_REQUIRED" | "CONSENT_NOT_FOUND" | "CONSENT_NOT_MATCH" | "GROUP_NOT_FOUND" | "GROUP_UPDATE_FORBIDDEN" | "GROUP_DELETE_FORBIDDEN" | "BATCH_NOT_FOUND" | "BATCH_CHUNK_NOT_FOUND") | N | ERROR | 오류 코드 |
{
"code": "BAD_REQUEST",
"message": "Failed to convert value of type 'java.lang.String' to required type 'java.lang.Boolean'"
}{
"code": "BAD_REQUEST",
"message": "Failed to convert value of type 'java.lang.String' to required type 'java.lang.Boolean'"
}{
"code": "BAD_REQUEST",
"message": "Validation failed for argument at index 0 in method"
}{
"code": "BAD_REQUEST",
"message": "Malformed JSON request"
}{
"code": "BAD_REQUEST",
"message": "Invalid argument"
}{
"code":