문서 본문으로 이동
문서API 참조주문 목록 조회
GETBearer 토큰

주문 목록 조회

/api/v1/orders

조직의 최근 주문을 최대 100건 조회합니다. 결제 완료가 서버 제공 완료를 의미하지는 않습니다.

API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.

요청 예시

cURL
curl "https://tovahub.com/api/v1/orders" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.

응답 예시
JSON
[]

매개변수

매개변수가 없습니다.

응답

HTTP 상태 200

현재 조직의 최근 주문을 최대 100개 담은 배열을 반환합니다.

[]array

응답의 최상위 값은 배열이며 orders 래퍼가 아닙니다.

[]._idstring (ObjectId)

주문 식별자입니다.

[].assetstring ('USD' | 'xTOVA')

저장된 결제 자산입니다.

[].amountstring

정수 USD 센트 또는 정수 xTOVA 단위입니다.

[].planIdstring

구매한 요금제 식별자입니다.

[].regionstring

구매한 지역 코드입니다.

[].daysnumber

구매한 청구 기간의 일수입니다.

[].hostnamestring

서버 호스트 이름입니다.

[].namestring (optional)

사용자가 지정한 표시 이름이며, 있는 경우에만 제공됩니다.

[].osstring

요청한 운영체제 식별자입니다.

[].statusstring ('pending' | 'provisioning' | 'completed' | 'failed' | 'refunded')

주문 이행 상태입니다.

[].providerServerIdstring | null

알려진 경우 공급업체 인스턴스 식별자입니다.

[].failureReasonstring | null

기록된 실패 사유이며, 있는 경우에만 제공됩니다.

[].createdAtstring (ISO 8601)

주문 생성 시각입니다.

[].updatedAtstring (ISO 8601)

주문 최종 업데이트 시각입니다.

[].paymentTxHashstring (optional)

기록된 블록체인 트랜잭션 해시입니다.

[].autoRenewboolean

원래 주문에 기록된 자동 갱신 설정입니다.