Skip to Content

List Paid Order Summary - ListPaidOrderSummary

Overview

Query aggregated completed (paid) order statistics by specified dimensions

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is ListPaidOrderSummary.Yes
PublicKeystringThe user’s public key can be obtained from Console Yes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
StartTimeintQuery start time (Unix timestamp, seconds), requiredYes
EndTimeintQuery end time (Unix timestamp, seconds), required; must be greater than StartTimeYes
ResourceIds.NstringResource ID list (optional)No
ModelIds.NstringModel ID list (optional)No
PricingUnits.NintPricing unit list (optional)No
OrderTypes.NintOrder type list (optional)No
ChargeTypes.NintCharge type list (optional)No
PricingSkus.NstringBilling unit SKU list (optional)No
ProductCodes.NstringProduct code list (optional). Enum: modelverse, sandboxNo
Regions.NstringRegion list (optional). See Region and Zone ListNo
OrganizationIds.NintOrganization ID list (optional)No

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
Summariesarray[OrderSummaryItem]Paid order summary listYes

Data Model

OrderSummaryItem

Field NameTypeDescription InformationRequired
ResourceIdstringResource IDNo
PricingSKUstringBilling unit SKUNo
ModelIDstringModel IDNo
ModelNamestringModel nameNo
PricingUnitintPricing unit (measurement unit)No
PricingUnitNamestringPricing unit nameNo
OrderTypeintOrder typeNo
OrderTypeDisplaystringOrder type display nameNo
ChargeTypeintChargeTypeNo
StatusintOrder status (2=Paid; 3=Cancelled)No
StatusDisplaystringOrder status display nameNo
ListPricestring
List price (original unit price)
No
DiscountPricestringDiscounted unit priceNo
SumQuantityintTotal usage quantity (raw value)No
SumQuantityDisplaystringTotal usage display (formatted, K tokens etc. are converted)No
SumOrderPricestringTotal order amountNo
SumOriginalPricestringTotal original priceNo
SumCashAccountstringTotal cash account deduction (only returned for paid orders)No
SumStarCardAccountstringTotal Star Card deduction amount (only returned for paid orders)No
SumBonusAccountstringTotal bonus account deduction (only returned for paid orders)No
SumCouponstringTotal coupon deduction (only returned for paid orders)No

Example

Request Example

https://api.dezai.com/?Action=ListPaidOrderSummary &Region=cn-zj &Zone=cn-zj-01 &ProjectId=pRaRcTyR &ResourceIds=GcNNUFXd &ModelIds=kZzfEgJH &PricingUnits=xJSAmIHa &OrderTypes=oxWOAWBD &ChargeTypes=jJHlYEWQ &StartTime=1 &EndTime=rpsXDfTb &ResourceIds=MBRJGfJr &ModelIds=HzLyYzfC &PricingUnits=MvBqNaFn &OrderTypes=HMrUmfFX &ChargeTypes=MWUTHbrb &StartTime=5 &EndTime=7 &ResourceIds.N=GtZdlexq &ModelIds.N=dufLMhYc &PricingUnits.N=3 &OrderTypes.N=3 &ChargeTypes.N=3 &StartTime=3 &EndTime=3 &ResourceIds.N=Lthksvru &ModelIds.N=eQNoCsux &PricingUnits.N=9 &OrderTypes.N=8 &ChargeTypes.N=7 &StartTime=6 &EndTime=5 &PricingSkus.N=vqcXxipb &ProductCodes.N=TCBxiHlp &Regions.N=QwmZlhIn &OrganizationIds.N=dAhmKEcI &Regions.N=AaPOmFNz &OrganizationIds.N=6

Response Example

{ "Action": "ListPaidOrderSummaryResponse", "Data": {}, "RetCode": 0 }