English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語
GET /api/v2/server-side-api/paywalls/

Danh sách paywall

Copy as Markdown

Truy xuất danh sách các paywall trong ứng dụng của bạn.

Query parameters

page[number]integer

Số trang để phân trang

page[size]integer

Số mục trên mỗi trang

Responses

Truy xuất paywall thành công

Schema
dataarray of objectrequired

Mảng các đối tượng paywall

titlestringrequired

Tên của paywall, như đã định nghĩa trong Adapty Dashboard của bạn

paywall_idstringrequired

Mã định danh duy nhất của paywall

use_paywall_builderbooleanrequired

Paywall có sử dụng Paywall Builder hay không

use_paywall_builder_legacybooleanrequired

Paywall có sử dụng Paywall Builder phiên bản cũ hay không

updated_atstringrequired

Thời điểm paywall được cập nhật lần cuối

created_atstringrequired

Thời điểm paywall được tạo

statestringrequired

Trạng thái hiện tại của paywall

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

is_deletedbooleanrequired

Paywall có được đánh dấu là đã xóa hay không

web_purchase_urlstring

URL dùng cho việc mua hàng qua web, nếu có

productsarray of objectrequired

Mảng các đối tượng sản phẩm chứa thông tin sản phẩm của paywall

product_idstringrequired

Mã định danh duy nhất của sản phẩm

titlestringrequired

Tiêu đề của sản phẩm

product_setstringrequired

Danh mục nhóm sản phẩm

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

offerobjectrequired
product_offer_idstringrequired

Mã định danh duy nhất của ưu đãi sản phẩm

titlestringrequired

Tiêu đề của ưu đãi

metaobjectrequired
paginationobjectrequired
countintegerrequired

Tổng số paywall

pageintegerrequired

Số trang hiện tại

pagesintegerrequired

Tổng số trang

Example 
{
  "data": [
    {
      "title": "LlkTlizT",
      "paywall_id": "fd891d4f-5906-45b9-97c1-13cc3dc665df",
      "use_paywall_builder": false,
      "use_paywall_builder_legacy": false,
      "updated_at": "2025-07-08T07:27:06.754527+00:00",
      "created_at": "2025-07-08T07:27:06.754541+00:00",
      "state": "live",
      "is_deleted": false,
      "web_purchase_url": null,
      "products": [
        {
          "product_id": "b95e9e51-a056-4eb6-9cf7-b75d139e7c3c",
          "title": "mFUQPcJQ",
          "product_set": "uncategorised",
          "offer": null
        }
      ]
    },
    {
      "title": "Premium Subscription",
      "paywall_id": "a1cf7850-1bb8-4151-8336-a4e588730c55",
      "use_paywall_builder": true,
      "use_paywall_builder_legacy": false,
      "updated_at": "2025-07-28T08:15:13.722680+00:00",
      "created_at": "2025-07-25T13:40:01.789853+00:00",
      "state": "live",
      "is_deleted": false,
      "web_purchase_url": "https://example.com/purchase",
      "products": [
        {
          "product_id": "b136422f-8153-402a-afbb-986929c68f6a",
          "title": "Premium Monthly",
          "product_set": "uncategorised",
          "offer": {
            "product_offer_id": "e31a4296-f250-4faf-ac80-3cc93c2da8f5",
            "title": "Free Trial"
          }
        }
      ]
    }
  ],
  "meta": {
    "pagination": {
      "count": 365,
      "page": 1,
      "pages": 183
    }
  }
}

Yêu cầu không hợp lệ

Schema
errorsarray of objectrequired
sourcestring

Nguồn gốc của lỗi

errorsarray of string

Mảng các thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP

Example 
{
  "errors": [
    {
      "source": "page_size",
      "errors": [
        "Invalid page_size parameter. Must be between 1 and 100."
      ]
    }
  ],
  "error_code": "validation_error",
  "status_code": 400
}

Không được phép

Schema
errorsarray of objectrequired
sourcestring

Nguồn gốc của lỗi

errorsarray of string

Mảng các thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP

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

Lỗi máy chủ nội bộ

Schema
errorsarray of objectrequired
sourcestring

Nguồn gốc của lỗi

errorsarray of string

Mảng các thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP