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

Paywall güncelle

Belirli bir paywall'ın remote config'ini günceller. Bu uç nokta, paywall'ın görünümünü ve davranışını özelleştirmenize yardımcı olan remote config değerlerini değiştirmenizi sağlar.

Önemli: Bir remote config güncellerseniz, mevcut tüm remote config'lerin üzerine yazılır! Mevcut remote config'leri korumak istiyorsanız, önce paywall'ı alın. Ardından oradan remote_configs'i kopyalayın ve güncelleme isteğinde ihtiyaç duyduğunuz nesneleri değiştirin.

Path parameters

paywall_idstring · uuidrequired

Güncellenecek paywall'ın benzersiz tanımlayıcısı

Request body

En az bir alan sağlanmalıdır

remote_configsarray of objectrequired

Güncellenecek RemoteConfig nesneleri dizisi

localestringrequired

Remote config için dil ayarı (ör. "en", "es", "fr")

datastringrequired

Remote config verilerini içeren JSON dizesi

Responses

Paywall başarıyla güncellendi

Schema

titlestringrequired

Adapty Kontrol Paneli'nde tanımlandığı şekliyle paywall'ın adı

paywall_idstringrequired

Paywall'ın benzersiz tanımlayıcısı

use_paywall_builderbooleanrequired

Paywall'ın Paywall Builder kullanıp kullanmadığı

use_paywall_builder_legacybooleanrequired

Paywall'ın eski Paywall Builder kullanıp kullanmadığı

updated_atstringrequired

Paywall'ın en son güncellendiği zaman damgası

created_atstringrequired

Paywall'ın oluşturulduğu zaman damgası

statestringrequired

Paywall'ın mevcut durumu

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

is_deletedbooleanrequired

Paywall'ın silinmiş olarak işaretlenip işaretlenmediği

web_purchase_urlstring

Varsa web satın alımları için URL

productsarray of objectrequired

Ürün bilgilerini içeren Ürün nesneleri dizisi

product_idstringrequired

Ürünün benzersiz tanımlayıcısı

titlestringrequired

Ürünün başlığı

product_setstringrequired

Ürün seti kategorisi

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

offerobjectrequired

product_offer_idstringrequired

Ürün teklifinin benzersiz tanımlayıcısı

titlestringrequired

Teklifin başlığı

remote_configsarray of object

Dil ve veri içeren RemoteConfig nesneleri dizisi

localestringrequired

Remote config için dil ayarı

datastringrequired

Remote config verilerini içeren JSON dizesi

main_screenshotobject

image_id ve url içeren ana ekran görüntüsü nesnesi

image_idintegerrequired

Görüntünün benzersiz tanımlayıcısı

urlstringrequired

Görüntünün URL'si

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"
  }
}

Hatalı istek

Schema

errorsarray of objectrequired

sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Example

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

Yetkisiz

Schema

errorsarray of objectrequired

sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Example

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

Paywall bulunamadı

Schema

errorsarray of objectrequired

sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Example

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

Sunucu içi hata

Schema

errorsarray of objectrequired

sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

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()