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

Paywall'ı güncelle

Belirli bir paywall'ın remote config değerlerini günceller. Bu endpoint, 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'ı getirin. Ardından, oradan remote_configs'i kopyalayın ve güncelleme isteğinde değiştirmeniz gereken nesneleri düzenleyin.

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 nesnelerinin dizisi

localestringrequired

Remote config için yerel ayar (örn. "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 Product nesnelerinin 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

Yerel ayar ve veri içeren RemoteConfig nesnelerinin dizisi

localestringrequired

Remote config için yerel 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örselin benzersiz tanımlayıcısı

urlstringrequired

Görselin 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()