PUT /api/v2/server-side-api/paywalls/{paywall_id}/

ペイウォールを更新する

特定のペイウォールのリモートコンフィグを更新します。このエンドポイントを使用して、ペイウォールの外観と動作をカスタマイズするためのリモートコンフィグ値を変更できます。

重要: リモートコンフィグを更新すると、既存のすべてのリモートコンフィグが上書きされます。既存のリモートコンフィグを保持する必要がある場合は、まずペイウォールを取得し、そこから remote_configs をコピーして、更新リクエストで必要なオブジェクトのみを変更してください。

Path parameters

paywall_idstring · uuidrequired

更新するペイウォールの一意の識別子

Request body

少なくとも 1 つのフィールドを指定する必要があります

remote_configsarray of objectrequired

更新する RemoteConfig オブジェクトの配列

localestringrequired

リモートコンフィグのロケール（例："en"、"es"、"fr"）

datastringrequired

リモートコンフィグデータを含む JSON 文字列

Responses

ペイウォールが正常に更新されました

Schema

titlestringrequired

Adapty ダッシュボードで定義されたペイウォールの名前

paywall_idstringrequired

ペイウォールの一意の識別子

use_paywall_builderbooleanrequired

ペイウォールビルダーを使用しているかどうか

use_paywall_builder_legacybooleanrequired

レガシーペイウォールビルダーを使用しているかどうか

updated_atstringrequired

ペイウォールが最後に更新されたタイムスタンプ

created_atstringrequired

ペイウォールが作成されたタイムスタンプ

statestringrequired

ペイウォールの現在の状態

One of: "draft", "live", "inactive", "archived"

is_deletedbooleanrequired

ペイウォールが削除済みとしてマークされているかどうか

web_purchase_urlstring

ウェブ購入用の URL（該当する場合）

productsarray of objectrequired

プロダクト情報を含む Product オブジェクトの配列

product_idstringrequired

プロダクトの一意の識別子

titlestringrequired

プロダクトのタイトル

product_setstringrequired

プロダクトセットのカテゴリ

One of: "weekly", "monthly", "trimonthly", "semiannual", "annual", "lifetime", "uncategorised", "nonsubscriptions", "two_months", "consumable"

offerobjectrequired

product_offer_idstringrequired

プロダクトオファーの一意の識別子

titlestringrequired

オファーのタイトル

remote_configsarray of object

ロケールとデータを含む RemoteConfig オブジェクトの配列

localestringrequired

リモートコンフィグのロケール

datastringrequired

リモートコンフィグデータを含む JSON 文字列

main_screenshotobject

image_id と url を含むメインスクリーンショットオブジェクト

image_idintegerrequired

画像の一意の識別子

urlstringrequired

画像の URL

Example

{
  "title": "Premium Subscription",
  "paywall_id": "fd891d4f-5906-45b9-97c1-13cc3dc665df",
  "use_paywall_builder": true,
  "use_paywall_builder_legacy": false,
  "updated_at": "2025-07-30T11:13:58.798Z",
  "created_at": "2025-07-30T11:13:58.798Z",
  "state": "live",
  "is_deleted": false,
  "web_purchase_url": "https://example.com/purchase",
  "products": [
    {
      "product_id": "b95e9e51-a056-4eb6-9cf7-b75d139e7c3c",
      "title": "Premium Monthly",
      "product_set": "uncategorised",
      "offer": {
        "product_offer_id": "e31a4296-f250-4faf-ac80-3cc93c2da8f5",
        "title": "Free Trial"
      }
    }
  ],
  "remote_configs": [
    {
      "locale": "en",
      "data": "{\"title\":\"Premium Features\",\"subtitle\":\"Unlock all premium content\"}"
    }
  ],
  "main_screenshot": {
    "image_id": 123456,
    "url": "https://public-media.adapty.io/public/screenshot.jpg"
  }
}

リクエストが不正です

Schema

errorsarray of objectrequired

sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

Example

{
  "errors": [
    {
      "source": "remote_configs",
      "errors": [
        "At least one field must be provided"
      ]
    }
  ],
  "error_code": "validation_error",
  "status_code": 400
}

認証エラー

Schema

errorsarray of objectrequired

sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

Example

{
  "errors": [
    "Invalid API key"
  ],
  "error_code": "unauthorized",
  "status_code": 401
}

ペイウォールが見つかりません

Schema

errorsarray of objectrequired

sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

Example

{
  "errors": [
    {
      "source": null,
      "errors": [
        "Paywall not found"
      ]
    }
  ],
  "error_code": "paywall_does_not_exist",
  "status_code": 404
}

内部サーバーエラー

Schema

errorsarray of objectrequired

sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

Try it

Authorization

Path parameters

paywall_id*

Body

curl --request PUT \
  --url 'https://api.adapty.io/api/v2/server-side-api/paywalls/{paywall_id}/' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "remote_configs": [
      {
        "locale": "en",
        "data": "{\"title\":\"Premium Features\",\"subtitle\":\"Unlock all premium content\"}"
      }
    ]
  }'

const response = await fetch('https://api.adapty.io/api/v2/server-side-api/paywalls/{paywall_id}/', {
  method: 'PUT',
  headers: {
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "remote_configs": [
      {
        "locale": "en",
        "data": "{\"title\":\"Premium Features\",\"subtitle\":\"Unlock all premium content\"}"
      }
    ]
  }),
});
const data = await response.json();

import requests

response = requests.put('https://api.adapty.io/api/v2/server-side-api/paywalls/{paywall_id}/', headers={
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
}, json={
      "remote_configs": [
        {
          "locale": "en",
          "data": "{\"title\":\"Premium Features\",\"subtitle\":\"Unlock all premium content\"}"
        }
      ]
    })
data = response.json()