アプリ内サブスクリプションの詳細

🚧

開発中の機能

アプリ内サブスクリプションは現在開発中であり、まもなくリリースされます。このエンドポイントはローンチ前に変更される可能性があります。

アプリケーションにリンクされた特定のアプリ内製品に関する詳細情報は、Aptoide Connect 開発者コンソールを介して、またはこの API エンドポイントを使用してプログラムで取得できます。

エンドポイント

メソッド	URL
GET	https://ws.catappult.io/api/applications/{applicationName}/subscriptions/{sku}

認証

この API にアクセスするには、Aptoide Connect でアクティブなアカウントサブスクリプションを持ち、API キーで認証する必要があります（生成方法はこちらを確認してください）。

⚠️

必要なアカウントタイプ

アプリ内サブスクリプションを取得できるのは、Developer タイプのアカウントのみです。

ヘッダー

ヘッダー	型	必須	説明
Api-Key	string	必須	API リクエストを認証するために使用されます。値は Aptoide Connect の API キーです。

パスパラメーター

パラメーター	型	説明
applicationName	string	アプリケーションの一意のパッケージ名（例：com.example.test）。
sku	string	取得するアプリ内サブスクリプションの一意の識別子（例：subscription01）。

クエリパラメーター

パラメーター	型	必須	説明
operatingSystem	string (URL)または file	任意（デフォルト：android）	アプリ内サブスクリプションのオペレーティングシステムを指定します。可能な値： • android • ios

レスポンス

成功

API 呼び出しが HTTP 200 ステータスコードを返した場合、リクエストは成功し、アプリ内サブスクリプションに関する詳細情報を含む JSON オブジェクトを返します。

レスポンスの例

{
    "addedTimestamp": "2025-01-01 00:00:00",
    "countryPrices": [
        {
            "amount": 2,
            "country": "PT",
            "currency": "EUR"
        }
    ],
    "freeTrialPeriod": null,
    "gracePeriod": null,
    "id": "BT3XD2PNZ54OHDC7",
    "locales": [
        {
            "description": "Descripcion",
            "isDefault": true,
            "locale": "es",
            "title": "Titulo"
        },
        {
            "description": "Descricao",
            "isDefault": false,
            "locale": "pt",
            "title": "Titulo"
        }
    ],
    "modifiedTimestamp": "2025-01-01 00:00:00",
    "period": "P1W",
    "referencePrice": {
        "amount": 1,
        "currency": "USD"
    },
    "sku": "subscription01",
    "status": "ACTIVE"
}