충전 내역
플랫폼에서 생성한 충전 요청 내역을 조회합니다.
GET
https://bank.apiacc.com/history쿼리 파라미터로 조건을 지정하여 충전 요청 목록을 페이지네이션 형태로 조회합니다.
쿼리 파라미터
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
platform특정 플랫폼의 요청만 조회합니다. | string | 선택 | — | "my-service" |
status
| string | 선택 | — | "approved" |
from조회 시작 시각(ISO 8601)입니다. | string | 선택 | — | "2026-08-01T00:00:00Z" |
to조회 종료 시각(ISO 8601)입니다. | string | 선택 | — | "2026-08-15T00:00:00Z" |
cursor다음 페이지를 위한 커서 값입니다. 이전 응답의 next_cursor를 사용하세요. | string | 선택 | — | "chg_cursor_abc" |
limit한 번에 반환할 최대 항목 수입니다. | integer | 선택 | 1~100, 기본값 20 | 20 |
curl -X GET "https://bank.apiacc.com/history?platform=my-service&status=approved&limit=20" \
-H "Authorization: Bearer $BANK_API_KEY" \
--max-time 10응답
200충전 내역 목록
{
"items": [
{
"id": "chg_example123",
"amount": 10000,
"depositor": "홍길동",
"platform": "my-service",
"ref": "order_1234",
"status": "approved",
"requested_at": "2026-08-15T03:00:00Z",
"approved_at": "2026-08-15T03:01:12Z"
},
{
"id": "chg_example124",
"amount": 5000,
"depositor": "김철수",
"platform": "my-service",
"ref": "order_1235",
"status": "pending",
"requested_at": "2026-08-15T02:40:00Z",
"approved_at": null
}
],
"next_cursor": "chg_cursor_def",
"has_more": true
}next_cursor가 null이면 마지막 페이지입니다.
주요 오류
| 상태 | error |
|---|---|
| 400 | invalid_date_range |
| 400 | invalid_cursor |
| 429 | rate_limit_exceeded |