Trang trên Duda (Pages v2)

Pages v2 API của Duda là backend cho create_page_draft và update_page_draft khi platform của site là duda.

Quy tắc bắt buộc

Trang luôn được tạo với draft_status: DRAFT. Worker từ chối mọi giá trị draft_status do caller cung cấp lúc create. Để chuyển sang STAGED_DRAFT (sẽ publish vào lần publish site kế tiếp), dùng update_page_draft với publish_on_next_site_publish: true tường minh.

Không có lịch theo thời gian cho trang Duda — schedule_page từ chối các site Duda. STAGED_DRAFT là trạng thái “sẵn sàng lên live” duy nhất, và trigger publish là người click Publish trong Duda admin.

Tạo

create_page_draft
  site_id="<duda-site-id>"
  title="Pricing"
  slug="pricing"
  seo={
    "title": "Pricing — Acme",
    "description": "Three tiers...",
    "no_index": false,
    "og_image": "https://cdn.example.com/og-pricing.png"
  }
  header_html="<script>...</script>"

Trả về { id: "<uuid>", status: "draft", url: "/pricing" }.

Cập nhật

Sửa các trường của một bản nháp. Đổi slug là rủi ro điển hình — Duda không cho phép đổi đường dẫn của trang chủ.

update_page_draft
  site_id="<duda-site-id>"
  page_id="<uuid>"
  title="Pricing 2026"
  seo={ "title": "Updated SEO title" }

Opt vào STAGED_DRAFT (publish ở lần publish site kế tiếp)

update_page_draft
  site_id="<duda-site-id>"
  page_id="<uuid>"
  publish_on_next_site_publish=true

Giờ trang sẽ lên live vào lần kế tiếp ai đó bấm nút Publish toàn cục trên dashboard Duda. Bạn có thể đưa về DRAFT bằng cách truyền flag là false (hoặc bỏ qua — server coi như không thay đổi).

Cái KHÔNG có trên trang Duda

• Page builder (arg page_builder, list_page_templates) — Duda không có khái niệm Gutenberg/Elementor
• Lên lịch theo thời gian (schedule_page) — xem ở trên
• create_page_from_code — chỉ WordPress