충전 내역
플랫폼에서 생성한 충전 요청 내역을 조회합니다.
GET
https://bank.dmolto.com/history상태와 반환 개수를 지정하여 최신 충전 요청 목록을 조회합니다.
쿼리 파라미터
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
status
| string | 선택 | — | "approved" |
limit한 번에 반환할 최대 항목 수입니다. | integer | 선택 | 1~100, 기본값 50 | 20 |
curl -X GET "https://bank.dmolto.com/history?status=approved&limit=20" \
-H "Authorization: $BANK_API_KEY" \
--max-time 10응답
200충전 내역 목록
{
"charges": [
{
"id": "chg_example123",
"api_key_id": "key_bank_123",
"amount": 10000,
"depositor": "홍길동",
"platform": "my-service",
"ref": "order_1234",
"status": "approved",
"requested_at": "2026-08-15T03:00:00Z",
"processed_at": "2026-08-15T03:01:12Z",
"expires_at": "2026-08-15T03:03:00Z"
},
{
"id": "chg_example124",
"api_key_id": "key_bank_123",
"amount": 5000,
"depositor": "김철수",
"platform": "my-service",
"ref": "order_1235",
"status": "pending",
"requested_at": "2026-08-15T02:40:00Z",
"expires_at": "2026-08-15T02:43:00Z"
}
]
}주요 오류
| 상태 | error |
|---|---|
| 400 | invalid_status |
| 400 | invalid_limit |
| 429 | rate_limit_exceeded |