PATCH /dataset/{schema_name}

เพิ่มหรืออัปเดต variant (แถวใน documents) ของคอมโพเนนต์แบบกำหนดเอง โดยใช้ id ของเอกสารเป็นคีย์ ระบุ id เพื่ออัปเดตตัวแปรที่มีอยู่แล้ว; ละไว้เพื่อแทรกตัวใหม่ ใช้งานได้ที่ /schemas/{schema_name} ด้วย เนื้อหาจะถูกตรวจสอบความถูกต้องตามสคีมาของคอมโพเนนต์.

การยืนยันตัวตน: คีย์ API — ต้องใช้เสมอ และคีย์ต้องมีสิทธิ์ content_write.

พารามิเตอร์เส้นทาง

พารามิเตอร์คิวรี

เนื้อหาในคำขอ

{
  "id": "<uuid>",
  "title": "ตัวแปรของฉัน",
  "content": { "title": "สวัสดี", "body": "..." }
}

การตอบกลับ

{
  "id": "...",
  "schema_name": "post",
  "title": "ตัวแปรของฉัน",
  "status": "ฉบับร่าง",
  "version": 2,
  "created": true
}

created จะเป็น true เมื่อแทรก (HTTP 201) และเป็น false เมื่ออัปเดต (HTTP 200).

ตัวอย่าง

curl -X PATCH '{CMS_API_URL}/dataset/post?websiteId=<uuid>' \
  -H 'x-api-key: <key>' \
  -H 'Content-Type: application/json' \
  -d '{"content":{"title":"สวัสดี"}}'

ข้อผิดพลาด

• 400 — websiteId ไม่ถูกต้อง, content ที่ไม่ใช่อ็อบเจ็กต์, คอมโพเนนต์ที่ไม่รู้จักหรือถูกเก็บถาวร, หรือการตรวจสอบไม่ผ่าน
• 401 — ไม่มีหรือคีย์ API ไม่ถูกต้อง
• 403 — คีย์ไม่มีสิทธิ์ content_write
• 404 — ระบุ id แต่ไม่พบตัวแปรที่ตรงกัน