Skip to content

Cloud Phone Renewal Price Calculation ​

Cloud phone renewal price calculation.

Interface Address:

text
/papi/order/renewal/price-calc

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID. See API Rules for authentication
X-SignaturestringYesSignature value, Base64-encoded HMAC-SHA256 result
X-TimestampstringYesMillisecond-level Unix timestamp (13 digits)
X-NoncestringYesRandom string, 10~32 lowercase letters + digits

Body Parameters:

The request body is an array, each element contains the following fields:

ParameterTypeRequiredDescription
skuCodestringYesSKU code
containerSidsarray[string]YesCloud phone ID list
packageCodestringYesPackage code

Request Example:

json
[
  {
    "skuCode": "cvqhptc25b",
    "containerSids": ["fIKM/0Z0rK4q32eN0Bet/w=="],
    "packageCode": "7dfg9d3c9u"
  }
]

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectResponse data
├─ totalContainerCountintegerTotal cloud phone count
├─ currencystringCurrency type
├─ currencySymbolstringCurrency symbol
├─ currencyUnitstringCurrency unit
├─ skuGroupResultsarray[object]SKU group calculation result list
├─├─ skuCodestringSKU code
├─├─ skuNamestringSKU name
├─├─ aliasCodestringSKU alias code
├─├─ packageCodestringPackage code
├─├─ packageNamestringPackage name
├─├─ packagePricenumberPackage price
├─├─ periodintegerPackage period
├─├─ unitintegerPeriod unit
├─├─ containerCountintegerCloud phone count
├─├─ originalPricenumberOriginal price (US cents)
├─├─ favorablePricenumberDiscounted price (US cents)
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": {
    "totalContainerCount": 0,
    "currency": "",
    "currencySymbol": "",
    "currencyUnit": "",
    "skuGroupResults": [
      {
        "skuCode": "",
        "skuName": "",
        "aliasCode": "",
        "packageCode": "",
        "packageName": "",
        "packagePrice": 0,
        "period": 0,
        "unit": 0,
        "containerCount": 0,
        "originalPrice": 0,
        "favorablePrice": 0
      }
    ]
  },
  "msg": ""
}

OpenAPI Docs