跳到主要内容

通过订阅令牌获取订阅数据(V2)

注意

该门户网站正在开发中。文档的完整版本请看这里.

此方法允许通过订阅令牌获取订阅信息。

交互参数

GET https://public-api.rustore.ru/public/glike/subscription/{packageName}/{subscriptionId}/{subscriptionToken}
属性类型描述必须布局填写示例
Public-TokenstringPublic API Rustore的访问令牌header
packageNamestring应用程序包的名称path
subscriptionIdstring产品订阅代码path
subscriptionTokenstring如何获取订阅令牌path111.123

成功响应的参数

属性类型描述必须填写示例
startTimeMillisstring订阅开始时间,以自纪元开始的毫秒计。1577826955637
expiryTimeMillisstring订阅到期时间,以自纪元开始的毫秒计。1609456386128
autoRenewingboolean订阅是否会在当前期限结束后自动续订。false
priceCurrencyCodestring订阅价格的ISO 4217货币代码。RUB
priceAmountMicrosstring订阅价格以微单位表示,其中1,000,000微单位等于一单位货币。例如,如果订阅价格为1.99欧元,则AmountMicros为1,990,000。749000000
countryCodestring用户发票国家/地区代码,在订阅提供时刻。RU
paymentStateint订阅支付状态。可能的值包括:0.等待支付 1.支付接收 2.免费试用版 3.等待延迟的升级/降级。已取消且过期的订阅不适用。否,只适用于活跃的订阅1
cancelReasonint订阅取消或不自动续订的原因。可能的值包括:0.用户取消订阅 1.系统取消订阅,如支付问题 2.订阅被新订阅替换 3.开发者取消订阅否,仅适用于状态为CLOSED的已取消订阅0
orderIdstring首次支付发票的标识符,与订阅购买相关。如果订阅有多个发票,标识符后会加上数量,以".."分隔。41456..3
acknowledgementStateint订阅产品确认状态。可能的值包括:0.还未确认 1.已确认1
introductoryPriceInfo{}object关于订阅的促销期信息。此字段并不表明订阅当前处于促销期。否,只适用于PROMO期间的订阅。
kindstring始终传递值 "androidpublisher#subscriptionPurchase"androidpublisher#subscriptionPurchase
purchaseTypeint始终传递值 "0"0

introductoryPriceInfo

属性类型描述必须填写示例
introductoryPriceCurrencyCodestringISO 4217货币代码用于订阅的初始价格否,只适用于PROMO期间的订阅。RUB
introductoryPriceAmountMicrosstring订阅的初始价格。货币与priceCurrencyCode匹配。以微单位表示,其中1,000,000微单位等于一单位货币。例如,如果订阅价格为1.99欧元,则AmountMicros为1,990,000。否,只适用于PROMO期间的订阅。599000000
introductoryPricePeriodstring以ISO 8601格式指定的初始价格期限。例如,"P1W"(一周)、"P1M"(一个月)、"P3M"(三个月)、"P6M"(六个月)和"P1Y"(一年)。否,只适用于PROMO期间的订阅。P1Y
introductoryPriceCyclesstring计算初始价格提议的周期数。否,只适用于PROMO期间的订阅。1

JSON响应示例

{
"startTimeMillis": "1694431707000",
"expiryTimeMillis": "1697034507000",
"autoRenewing": true,
"priceCurrencyCode": "RUB",
"priceAmountMicros": "749000000",
"countryCode": "RU",
"paymentState": 1,
"orderId": "33252..1",
"acknowledgementState": 1,
"kind": "androidpublisher#subscriptionPurchase",
"purchaseType": 0,
"introductoryPriceInfo":
{
"introductoryPriceCurrencyCode": "RUB",
"introductoryPriceAmountMicros": "599000000",
"introductoryPricePeriod": "P1M",
"introductoryPriceCycles": "1"
}
}

错误响应的参数

属性类型描述必须填写示例
error{}object错误数据对象是,如果响应代码!=200

error

属性类型描述必须填写示例
codenumberhttp响应代码
messagestring响应代码解释

message

codemessage
400The subscription purchase token does not match the subscription ID.
404No subscription purchase matches the subscription ID.