ovahubGETBearer 토큰
청구 이력 조회
/api/v1/history
고정 팀의 서버와 사설 네트워크 구매·갱신을 제품과 시간으로 먼저 필터링한 뒤 페이지당 20개씩 반환합니다. 확인되지 않은 결과는 미확인으로 유지합니다.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
cURL
curl "https://tovahub.com/api/v1/history?product=all&page=1" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
응답 예시
JSON
{
"userId": "507f1f77bcf86cd799439012",
"page": 1,
"limit": 20,
"total": 1,
"items": [
{
"_id": "network:507f1f77bcf86cd799439013",
"product": "network",
"kind": "purchase",
"amount": "990",
"coin": "USD",
"hostname": "team-switch",
"status": "completed",
"createdAt": "2026-11-12T00:00:00.000Z"
}
]
}매개변수
product쿼리 · 선택string
all, server 또는 network이며 기본값은 all입니다.
page쿼리 · 선택integer
페이지 번호는 1–10000이며 페이지당 20개입니다.
from쿼리 · 선택string
시작을 포함하는 ISO 8601 UTC 시간입니다. from과 to를 함께 지정하거나 둘 다 생략합니다.
to쿼리 · 선택string
from 이후인 ISO 8601 UTC 종료 시간이며 종료는 제외합니다. 클라이언트 시간대에서 포함할 날짜를 자정 경계로 변환합니다.
응답
HTTP 상태 200
서버와 사설 네트워크의 구매·갱신 기록을 먼저 필터링한 뒤 페이지로 나눕니다.
userIdstring인증된 조회자의 ID입니다. 팀은 인증 정보로 고정됩니다.
pageinteger요청한 페이지 번호이며 1부터 시작합니다.
limit20고정 페이지 크기입니다.
totalinteger고정 팀에서 조건에 맞는 기록의 총 개수입니다.
itemsarray안전한 행에 _id, product(server/network), kind(purchase/renew), 정수 문자열 amount, coin(USD/xTOVA), hostname, status, createdAt을 포함합니다. 공급자 데이터와 자격 증명은 제외합니다.