สำหรับนักพัฒนา
Zinn Digital® เป็นแพลตฟอร์มแบบ API-first เอ็นจิ้น API ตัวเดียวกับที่ขับเคลื่อนแดชบอร์ดของเราคือสิ่งที่คุณจะได้รับ ซึ่งมีการกำหนดเวอร์ชัน ยึดตามสเปกเป็นหลัก และจัดทำเอกสารประกอบครบ 100% ณ เวลาที่บิวด์ พร้อมด้วย SDK ที่สร้างขึ้นอัตโนมัติ, CLI, ผู้ให้บริการ Terraform, เว็บฮุกที่ลงนาม และเซิร์ฟเวอร์ MCP ที่อยู่ด้านบน ไม่ว่าคุณจะใช้เครื่องมือใดในการทำงาน ไม่ว่าจะเป็นเทอร์มินัล, ไปพไลน์, ไฟล์สถานะ หรือ AI agent แพลตฟอร์มนี้พร้อมรองรับทั้งหมด
โฮสต์ส่วนใหญ่เพิ่ม API เข้ากับแผงควบคุมในภายหลัง และมันก็แสดงให้เห็นอย่างชัดเจน โดยฟีเจอร์ครึ่งหนึ่งของแผงควบคุมไม่เคยใช้งานได้จริง เราสร้างขึ้นมาในทางตรงกันข้าม แดชบอร์ด, คอนโซลผู้ดูแลระบบ, CLI, ผู้ให้บริการ Terraform, MCP server และการบูรณาการของคุณเอง ล้วนใช้งานเอ็นจิ้น API ตัวเดียวกัน หากคุณทำได้ในแผงควบคุม คุณก็ทำได้ด้วยโค้ดเช่นกัน
สเปก OpenAPI คือแหล่งข้อมูลที่ถูกต้องแท้จริง และจะไม่มีเอนด์พอยต์ใดถูกปล่อยใช้งานเว้นแต่จะอยู่ในสเปกนั้น กฎข้อเดียวนั้นคือสิ่งที่ทำให้ API สาธารณะมีเอกสารประกอบครบถ้วนตั้งแต่ตอนบิลด์แทนที่จะเป็นภายหลัง ไม่มีจุดอับที่ไม่มีเอกสาร เพราะเอนด์พอยต์ที่ไม่มีเอกสารจะไม่สามารถมีอยู่จริงได้
เอกสารอ้างอิงแบบอินเทอร์แอกทีฟ, ไคลเอนต์ SDK ทั้งสี่ชุด, ส่วนใหญ่ของ CLI และโครงสร้างพื้นฐานของ Terraform provider ล้วนถูกสร้างขึ้นจากสเปกตัวเดียวกันนั้น แหล่งข้อมูลเดียว, ผลลัพธ์หลากหลาย, ซิงค์ตรงกันเสมอ — คุณจะไม่ต้องคอยไล่ตามเอกสารที่คลาดเคลื่อนไปจากระบบที่ใช้งานจริงอีกต่อไป
จุดสิ้นสุด (Endpoints) อยู่ภายใต้ /v1 พร้อมนโยบายการเลิกใช้งานที่ประกาศไว้และบันทึกการเปลี่ยนแปลง คุณจะได้รับแจ้งล่วงหน้าก่อนที่จะมีการเปลี่ยนแปลงใดๆ เป็นลายลักษณ์อักษร แทนที่จะต้องมาพบด้วยตัวเองจากบิลด์ที่ล้มเหลว
การทดสอบสัญญาแบบ implementation-versus-spec และการตรวจความถูกต้องของ OpenAPI จะทำงานในทุกการเปลี่ยนแปลง ความไม่สอดคล้องกันระหว่างโค้ดและสัญญาจะทำให้บิลด์ล้มเหลว ดังนั้น สเปคที่คุณใช้สร้างไคลเอนต์จึงเป็นสเปคที่เซิร์ฟเวอร์รองรับจริงๆ
มีช่องทางเข้าถึงสองทาง แต่มีหลักการพื้นฐานเดียวกัน ไม่ว่าคุณจะเลือกวิธีใด การตรวจสอบสิทธิ์แบบเดียวกันและการแยกระดับฐานข้อมูลแบบเดียวกันจะถูกนำมาใช้
คีย์มีรูปแบบเป็น zdk_<mode>_<prefix>_<secret> ระบบจะจัดเก็บเฉพาะแฮช SHA-256 ของรหัสลับเท่านั้น — เราไม่สามารถแสดงคีย์ให้คุณเห็นอีกครั้งหลังจากการออกคีย์ และไม่มีใครที่เข้าถึงฐานข้อมูลของเราที่ทำได้เช่นกัน คีย์จะมีขอบเขตการใช้งาน สามารถเพิกถอนได้ และออกให้ในระดับองค์กรไม่ใช่ระดับบุคคล
คีย์แซนด์บ็อกซ์แยกต่างหากจากคีย์ใช้งานจริงและทำงานในโหมดแซนด์บ็อกซ์: ไม่มีระบบเรียกเก็บเงินจริง ไม่มีระบบจัดเตรียมทรัพยากรจริง การทดสอบการผสานรวมของคุณสามารถเรียกใช้งาน API ซ้ำๆ ได้โดยไม่ต้องเสียเงินหรือสร้างเซิร์ฟเวอร์ขึ้นมา
เซสชันของผู้ใช้จะทำการยืนยันตัวตนด้วย JWT ที่ออกโดย Keycloak ซึ่งได้รับการตรวจสอบกับคีย์สาธารณะของรีล์ม และแปลงเป็นออบเจ็กต์ Principal ตัวเดียวกันกับที่คีย์ API ใช้ ปลายทางจะจำกัดการเข้าถึงด้วยคีย์สิทธิ์แบบละเอียด เช่น sites.create หรือ apikeys.manage ซึ่งจะตรวจสอบเป็นรายองค์กร โดยสิทธิ์ในองค์กรหนึ่งจะไม่ให้สิทธิ์การเข้าถึงในองค์กรอื่นที่แยกจากกันและไม่เกี่ยวข้องกัน แม้ว่าสิทธิ์นั้นจะใช้ได้กับองค์กรย่อยที่อยู่ภายใต้ก็ตาม
คำขอของผู้เช่าแต่ละรายการทำงานในทรานแซกชันโดยตั้งค่าขอบเขตองค์กร Postgres จากหลักการ ดังนั้นการแยกส่วนจึงถูกบังคับใช้โดยฐานข้อมูล ไม่ใช่โดยตัวกรอง ORM ที่ใครบางคนอาจลืม ตัวกรอง queryset ยังคงมีอยู่เพื่อเป็นการป้องกันเชิงลึก
API นั้นทำให้ดูดีในไฟล์ README ได้ง่าย แต่ทำให้ใช้งานได้จริงภายใต้ปริมาณการใช้งานจริงนั้นยาก ส่วนเหล่านี้คือสิ่งที่เราทุ่มเทอย่างหนัก เพราะมันคือส่วนที่ทำให้ระบบที่เชื่อมintegrationพังตอนตีสาม
มีรายละเอียดประเด็นหนึ่งที่ควรกล่าวถึง เนื่องจากมีผลต่อพฤติกรรมของการทำงานแบบกลุ่ม (bulk work): รหัส 409 สำหรับโดเมนที่ซ้ำกันจะตอบคำถามว่า "โฮสต์ชื่อนี้อยู่ที่นี่หรือไม่" สำหรับทุกผู้เชนท์ (tenant) ซึ่งเป็นออราเคิลการแจกแจง (enumeration oracle) และมีความเสี่ยงจริงในการเปิดเผยตัวตน (deanonymisation risk) ต่อ Footprint-Free การจำกัดปริมาณการสร้างเว็บไซต์ (throttling) น่าจะเป็นการแก้ปัญหาแบบง่ายๆ แต่จะทำให้ผลิตภัณฑ์การจัดเตรียมแบบกลุ่ม (bulk-provisioning) ใช้การไม่ได้ไปเลย แทนที่จะทำเช่นนั้น มีเพียงความพยายามสร้างโดเมนซ้ำที่ถูกปฏิเสธเท่านั้นที่จะถูกนำมาคิดโควตา ต่อหนึ่งพรินซิพัล (principal) การสร้างที่สำเร็จจะไม่ถูกหักโควตาใดๆ ทั้งสิ้น — ดังนั้นคุณจึงสามารถจัดเตรียมแบบกลุ่มได้ตลอดทั้งวัน และการตรวจสอบจะถูกระงับแทบจะในทันที
สามผู้บริโภคที่มีสเปกเดียวกัน สำหรับสามแนวทางการทำงานที่แตกต่างกัน
สร้างขึ้นสำหรับ TypeScript, Python, PHP และ Go โดยติดตามสเปกเพื่อให้เอนด์พอยต์ใหม่มาถึงในภาษาของคุณได้ทันทีโดยไม่ต้องรอแร็ปเปอร์ที่เขียนด้วยมือ
สร้างโครงร่างเว็บไซต์ WordPress, รันในเครื่องโดยไม่ต้องติดตั้งอะไรนอกจาก Node และปรับใช้เว็บไซต์นั้น Zinnector® จะตรวจสอบโปรเจกต์ของคุณล่วงหน้าเทียบกับสล็อตที่คุณกำลังจะปรับใช้ — เวอร์ชัน PHP, ดิสก์, จำนวนไฟล์ — และเตือนก่อนที่คุณจะพุช (push) แทนที่จะเป็นหลังจากนั้น นอกจากนี้ยังลงชื่อเข้าใช้, แสดงรายการเว็บไซต์, ปรับใช้, จัดการโดเมนและ DNS, อ่านบริการเมล, สำรองข้อมูล, รัน WP-CLI ที่อยู่ในรายการที่อนุญาต, ติดตามบันทึก (tails logs) และเรียกใช้งานชุดข้อมูลจำนวนมาก ฟรี, อนุญาตภายใต้สัญญาอนุญาต MIT, และสร้างขึ้นบน API สาธารณะเดียวกันนี้
จัดการเว็บไซต์ โดเมน ระเบียน DNS กล่องจดหมาย และแพ็กเกจในรูปแบบโครงสร้างพื้นฐานเป็นโค้ด (Infrastructure as Code) คำสั่ง terraform apply จะจัดเตรียมโฮสติ้ง และสภาพแวดล้อมของคุณจะสามารถทำซ้ำและตรวจสอบได้ แทนที่จะเป็นการคลิกหลายขั้นตอนที่ไม่มีใครบันทึกไว้
เอกสารที่สร้างขึ้นซึ่งคุณสามารถอ่านและเรียกใช้งานได้จากเบราว์เซอร์ โดยอธิบายเอนด์พอยต์ที่เซิร์ฟเวอร์ใช้งานอยู่จริงอย่างแม่นยำ เนื่องจากทั้งสองอย่างมาจากสเปกเดียวกัน
เบื้องหลังแพลตฟอร์มนี้คือโครงสร้างเหตุการณ์ที่ทนทาน: ทุกการเปลี่ยนแปลงสถานะจะเขียนเหตุการณ์ลงในเอาต์บ็อกซ์แบบทรานแซกชันใน Postgres แบบอะตอมิกพร้อมกับการเปลี่ยนแปลงฐานข้อมูล และตัวรีเลย์จะเผยแพร่ไปยัง NATS JetStream เหตุการณ์ต่างๆ มีการกำหนดประเภทและเวอร์ชัน ได้แก่ site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending และอื่นๆ
ลงทะเบียนปลายทางเป็น WebhookSubscription และเลือกประเภทเหตุการณ์ที่ต้องการรับ สตรีมเดียวทำหน้าที่ป้อนการแจ้งเตือน การวิเคราะห์ ระบบอัตโนมัติ และการผสานรวมของคุณในเวลาเดียวกัน คุณกำลังใช้งานเหตุการณ์ชุดเดียวกับที่เราใช้
ทุกการส่งข้อมูลได้รับการลงชื่อแบบ HMAC เพื่อให้คุณตรวจสอบได้ว่ามาจากเราจริงก่อนที่จะดำเนินการใดๆ
การส่งเว็บฮุกที่ล้มเหลวจะถูกลองใหม่โดยเว้นระยะเวลาเพิ่มขึ้นเรื่อย ๆ (backoff) และทุกครั้งที่พยายามจะถูกบันทึกเป็น WebhookDelivery คุณสามารถตรวจสอบและส่งเว็บฮุกซ้ำได้จากแดชบอร์ด โดยไม่ต้องส่งอีเมลหาฝ่าย support เพื่อถามว่าเราส่งอะไรไปบ้าง
ท่อส่งข้อมูลนี้ตั้งใจออกแบบมาให้ส่งแบบอย่างน้อยหนึ่งครั้ง (at-least-once) แทนที่จะแสร้งทำเป็นส่งแบบครั้งเดียวพอดี (exactly-once) รีเลย์ที่ล่มกลางคันระหว่างเผยแพร่จะหมดอายุสิทธิ์การถือครอง และเหตุการณ์ของมันจะถูกเผยแพร่ซ้ำ ทำการขจัดข้อมูลที่ซ้ำกันด้วยไอดีซองจดหมาย แล้วผู้บริโภคของคุณจะทำงานได้อย่างถูกต้องโดยโครงสร้าง
API เป็นเพียงครึ่งหนึ่งของเรื่องราวสำหรับนักพัฒนา อีกครึ่งหนึ่งคือการเผยแพร่ใช้งานจริง
เราให้บริการแพลตฟอร์มในรูปแบบ MCP server แบบโฮสต์: ซึ่งเป็นอะแดปเตอร์โปรโตคอลขนาดเล็กที่ทำงานคร่อม engine API โดยนำแคตตาล็อกการทำงาน ระบบ RBAC และบันทึกการตรวจสอบ (audit trail) ชุดเดียวกันมาใช้ซ้ำ เชื่อมต่อ Claude Code, Cursor, ChatGPT, Claude Desktop หรือไคลเอนต์ใดก็ตามที่รองรับ MCP เพียงครั้งเดียว ฟังก์ชันการทำงานทุกอย่างที่เราเพิ่มเข้าไปใน API จะสามารถใช้งานได้ทันทีโดยอัตโนมัติ
เอเจนต์จะได้รับสิ่งสำคัญสามประการ ได้แก่ เครื่องมือ (เอปไอนต์พอยต์เดียวกัน ไม่ต้องมีตรรกะคู่ขนานที่อาจคลาดเคลื่อน) ทรัพยากร (สถานะสุขภาพของเว็บไซต์แบบอ่านอย่างเดียว, การกำหนดค่า,บันทึกล่าสุด, เมตริก, เวลาทำงาน และบทความฐานความรู้ เพื่อให้สามารถวินิจฉัยด้วยข้อมูลจริงก่อนดำเนินการ) และพรอมต์ (เทมเพลตเวิร์กโฟลว์ที่เผยแพร่แล้ว เช่น "วินิจฉัยเว็บไซต์นี้" หรือ "เตรียมการย้ายข้อมูล")
ความปลอดภัยก็เป็นเช่นเดียวกับการยืนยันตัวตน: OAuth 2.1, โทเค็นที่ผูกกับองค์กรของคุณและสิทธิ์ RBAC ที่บังคับใช้ความปลอดภัยระดับแถว, กำหนดขอบเขตและเพิกถอนได้ต่อเครื่องมือ, แซนด์บ็อกซ์ที่แยกจากระบบจริง การกระทำที่มีความเสี่ยงสูง — ลบ, ระงับ, การเรียกเก็บเงิน, การใช้จ่ายจำนวนมาก — ต้องมีการยืนยันอย่างชัดเจนหรือนโยบายอนุมัติโดยมนุษย์ ขีดจำกัดอัตราและเพดานการใช้จ่ายจำกัดการกระทำแบบเสียค่าใช้จ่ายที่ทริกเกอร์โดย AI และการเรียก MCP ทุกครั้งจะถูกบันทึกประวัติการตรวจสอบพร้อมระบุตัวตน, เครื่องมือ, อาร์กิวเมนต์ และผลลัพธ์
เราสนับสนุนโปรโตคอลแทนที่จะต้องบูรณาการทีละแอป ซึ่งหมายความว่าคุณสามารถเปลี่ยนเครื่องมือ AI ที่เลือกใช้ได้โดยที่การบูรณาการโฮสติ้งของคุณไม่ต้องเปลี่ยนแปลงตามไปด้วย
ใช่ — นี่คือ API เอ็นจิ้นตัวเดียวกัน ได้รับการเผยแพร่และผ่านการทดสอบความเสถียรแล้ว แดชบอร์ด, คอนโซลผู้ดูแลระบบ, CLI, ผู้ให้บริการ Terraform, เซิร์ฟเวอร์ MCP และเว็บฮุก ล้วนเป็นผู้ใช้งานส่วนต่อประสานเดียวกัน ซึ่งเป็นสาเหตุที่ทำให้ API ไม่มีความล่าช้ากว่าแผงควบคุม
ใช่ครับ คีย์แซนด์บ็อกซ์จะถูกออกแยกต่างหากจากคีย์โปรดักชันและทำงานในโหมดทดสอบ โดยจะไม่มีการเรียกเก็บเงินจริงและไม่มีการจัดเตรียมทรัพยากรจริง คุณสามารถกำหนดค่า CI ของคุณให้ใช้ข้อมูลรับรองของแซนด์บ็อกซ์และทดสอบวงจรการส่งคำขอและการตอบกลับทั้งหมดได้อย่างปลอดภัย
ส่ง Idempotency-Key มาในคำขอ POST ของคุณ บันทึกการเล่นซ้ำจะถูกเขียนขึ้นเมื่อคอมมิตแทนที่จะเขียนแบบอินไลน์ ดังนั้นคำขอที่ลองใหม่จึงไม่มีทางเล่นซ้ำผลลัพธ์สำเร็จที่แคชไว้สำหรับแถวที่ไม่ได้คอมมิตจริงๆ และคำขอที่ล้มเหลวจะปลดล็อกทันทีเพื่อให้คำขอที่แก้ไขแล้วของคุณไม่ต้องรอนาน การจัดส่งเว็บฮุคเป็นการส่งแบบอย่างน้อยหนึ่งครั้งโดยการออกแบบ โปรดทำเดดยูพ (deduplicate) ที่รหัสซองจดหมาย (envelope id) ฝั่งคุณ
ไม่ใช่ในวันนี้ คีย์ API จะออกให้ต่อหนึ่งองค์กร ดังนั้นการบูรณาการที่ครอบคลุมหลายองค์กรของลูกค้าจะมีคีย์สำหรับแต่ละแห่ง นอกจากนี้ยังมีการตรวจสอบสิทธิ์ต่อองค์กรสำหรับหลักการของผู้ใช้ด้วย: การมี sites.create ในองค์กรหนึ่งจะไม่ให้สิทธิ์เข้าถึงในองค์กรอื่นที่แยกต่างหากและไม่เกี่ยวข้องกัน แม้ว่าสิทธิ์นั้นจะมีผลกับองค์กรที่อยู่ภายใต้องค์กรดังกล่าวก็ตาม นั่นคือความตั้งใจ เพื่อจำกัดขอบเขตของคีย์ที่ถูกบุกรุกให้อยู่ ภายในองค์กรของตนเองและองค์กรย่อยที่อยู่ภายใต้เท่านั้น ไม่ใช่ทั้งแพลตฟอร์ม
บทบาทนักพัฒนาครอบคลุมการอ่านข้อมูลองค์กร การจัดการคีย์ API การดูและการสร้างเว็บไซต์ การรีสตาร์ทเว็บไซต์ การล้างแคช และการดูและตอบกลับตั๋วสนับสนุน โดยจะจงใจไม่รวมการควบคุมการเรียกเก็บเงิน โปรดทราบว่าสิทธิ์ในการปรับใช้ (deploy) และการส่งข้อมูลขึ้นใช้งานจริง (push-to-live) ไม่ได้เป็นส่วนหนึ่งของบทบาทนี้ หากสมาชิกในทีมต้องการสิทธิ์ดังกล่าว โปรดกำหนดบทบาทที่มีสิทธิ์นั้นให้แทนที่จะถือว่า Developer เป็นบทบาททางเทคนิคที่กว้างที่สุด
การส่งข้อมูลซ้ำจะใช้ระบบหน่วงเวลาแบบ exponential backoff และทุกความพยายามจะถูกบันทึกเป็น WebhookDelivery ที่คุณสามารถตรวจสอบได้ ระบบต้นทางจะบันทึกเหตุการณ์ลงใน outbox แบบ transactional ใน database transaction เดียวกับการเปลี่ยนแปลงนั้นๆ ดังนั้น จะไม่มีข้อมูลใดสูญหายในระหว่างที่ผู้บริโภคข้อมูลไม่พร้อมใช้งาน ผู้บริโภคที่ระบบล่มจะทำงานล่าช้า แต่จะไม่ทำให้ผู้ผลิตข้อมูลหยุดทำงาน และคุณสามารถเล่นซ้ำการส่งข้อมูลได้จากแดชบอร์ดเมื่อระบบกลับมาใช้งานได้ปกติ
เริ่มต้นทดลองใช้ Footprint-Free Hosting ฟรี 14 วันแบบไม่ต้องใช้บัตรเครดิต รองรับสูงสุด 5 เว็บไซต์ แพ็กเกจแบบชำระเงินของ Footprint-Free เริ่มต้นที่ $6/เดือน สำหรับ PBN 5 ทุกแผนมาพร้อมกับการรับประกันคืนเงินภายใน 30 วัน ย้ายเว็บไซต์ฟรี และไม่มีการผูกมัดกับผู้ให้บริการ
API แบบสเปกนำ, SDK ที่สร้างขึ้นอัตโนมัติ, CLI, ผู้ให้บริการ Terraform, เว็บฮุกที่เซ็นชื่อ และเซิร์ฟเวอร์ MCP บนโฮสติ้งที่เราสร้างขึ้นสำหรับเว็บไซต์กว่า 650,000 แห่งทั่วโลก เริ่มต้นด้วยทดลองใช้งานฟรี 14 วัน ไม่ต้องใช้บัตรเครดิต และไม่ต้องระบุข้อมูลการชำระเงิน
เริ่มใช้งานฟรี