Хөгжүүлэгчдэд зориулав
Zinn Digital® бол API-эхэнд тавьсан платформ юм. Манай хяналтын самбарыг ажиллуулдаг яг тэрхүү хөдөлгүүрийн API-ийг та авах бөгөөд энэ нь хувилбаржуулсан, техникийн тодорхойлолтыг эн тэргүүнд тавьсан, бүтээх үед 100% баримтжуулагдсан ба дээр нь үүсгэсэн SDK-ууд, CLI, Terraform нийлүүлэгч, гарын үсэгтэй вэбхүүкүүд болон MCP сервертэй. Та ажлаа хийхдээ юу ч ашигладаг байсан — терминал, дамжуулах хоолой, төлөвийн файл эсвэл хиймэл оюун ухааны агент ч бай — платформ нь түүнд хариу үйлдэл үзүүлдэг.
Ихэнх хостууд хяналтын самбарт API-г дараа нь нэмж залгадаг бөгөөд энэ нь илт харагддаг — самбарын боломжуудын тал нь хэзээ ч гадагш гардаггүй. Бид үүнийг эсрэгээр нь бүтээсэн. Хянах самбар, админ удирдлагын хэсэг, CLI, Terraform нийлүүлэгч, MCP сервер болон таны өөрийн интеграциуд бүгд ижил хөдөлгүүрийн API-г ашигладаг. Хэрэв та самбар дээр хийж чадаж байвал кодоор ч бас хийж чадна.
OpenAPI тодорхойлолт нь үнэний цорын ганц эх сурвалж бөгөөд уг тодорхойлолтод тусгагдаагүй л бол ямар ч эцсийн цэг (endpoint) гарахгүй. Энэхүү ганц дүрэм нь нийтийн API-г эцэст нь биш, харин бүтээх үед бүрэн баримтжуулагдсан байлгадаг шалтгаан юм — баримтжуулагдаагүй эцсийн цэг оршин тогтнох боломжгүй тул баримтжуулагдаагүй булан гэж байхгүй.
Интерактив лавлах баримт бичиг, дөрвөн хэрэглэгчийн SDK, CLI-ийн ихэнх хэсэг болон Terraform үйлчилгээ үзүүлэгчийн бүтцийн суурь нь бүгд тэрхүү нэг тодорхойлолтоос үүсгэгддэг. Нэг эх сурвалж, олон олдвор, үргэлж синхрончлогдсон — та хэрэгжүүлэлтээсээ зөрсөн баримт бичгийг хэзээ ч хөөцөлдөх шаардлагагүй болно.
Төгсгөлийн цэгүүд нь нийтлэгдсэн хүчингүй болгох бодлого болон өөрчлөлтийн бүртгэлийн хамт /v1 доор байрладаг. Та бүтэлгүйтсэн бүтээлтээс олж мэдэхийн оронд ямар нэгэн зүйл өөрчлөгдөхөөс өмнө бичгээр мэдэгдэл хүлээн авах болно.
Хэрэгжүүлэлт болон тодорхойлолтын хоорондын гэрээний тестүүд болон OpenAPI шалгалт нь өөрчлөлт бүрд ажилладаг. Код болон гэрээний хоорондох зөрүү нь угсралтыг амжилтгүй болгодог — иймд таны клиентийг үүсгэсэн тодорхойлолт нь серверийн бодитоор мөрддөг тодорхойлолт юм.
Нэвтрэх хоёр арга, тэдгээрийн цаана нэгдмэл нэг зарчим бий. Та алийг нь ч ашигласан зөвшөөрлийн ижил шалгалтууд болон өгөгдлийн сангийн түвшний ижил тусгаарлалт үйлчилнэ.
Түлхүүрүүд zdk_<mode>_<prefix>_<secret> хэлбэртэй байна. Зөвхөн нууц үгийн SHA-256 хэшийг хадгалдаг — түлхүүр олгогдсоны дараа бид танд дахин харуулах боломжгүй бөгөөд манай мэдээллийн санд хандсан хэн ч үүнийг харах боломжгүй. Түлхүүрүүд нь хамрах хүрээтэй, хүчингүй болгох боломжтой бөгөөд хувь хүнд бус байгууллага бүрт олгогддог.
Sandbox түлхүүрүүд нь production түлхүүрүүдээс тусдаа бөгөөд sandbox горимд ажилладаг: бодит төлбөр тооцоо хийгдэхгүй, бодит нөөц хуваарилалт хийгдэхгүй. Таны интеграцийн тестүүд мөнгө үрэхгүйгээр эсвэл сервер босгохгүйгээр API-д эрчимтэй хүсэлт илгээх боломжтой.
Хэрэглэгчийн сессүүд нь realm нийтийн түлхүүрээр баталгаажсан Keycloak-аас олгосон JWT-ээр баталгаажиж, API түлхүүрийн нэгэн адил Principal объект болж шийдэгдэнэ. Төгсгөлийн цэгүүдийг sites.create эсвэл apikeys.manage зэрэг нарийвчилсан зөвшөөрлийн түлхүүрүүдээр хянадаг ба байгууллага тус бүрээр шалгадаг — нэг байгууллагын зөвшөөрөл нь тусдаа, хамааралгүй байгууллагад хандах эрх олгохгүй боловч түүний доор байрлах байгууллагуудад хамаарна.
Түрээслэгчийн хүсэлт бүр үндсэн этгээдээс тохируулсан Postgres байгууллагын хамрах хүрээ бүхий гүйлгээнд ажилладаг тул тусгаарлалтыг хэн нэгний мартаж болох ORM шүүлтүүрээр бус, өгөгдлийн сангаар хангадаг. Queryset шүүлтүүр нь гүнзгийрүүлсэн хамгаалалт хэлбэрээр байсаар байна.
README дээр API-г сайн харагдуулах нь амархан боловч бодит ачааллын үед найдвартай ажиллуулах нь хэцүү байдаг. Энэ бол шөнийн гурван цагт интеграцыг эвддэг эмзэг хэсгүүд тул бид эдгээрт хамгийн их хүчин чармайлт гаргасан юм.
Бөөнөөр гүйцэтгэх ажлын явцад нөлөөлдөг тул онцлон дурдах нэгэн нарийн зүйл: давхардсан домэйн дээрх 409 алдаа нь аливаа түрээслэгчийн хувьд "энэ хостын нэр энд байршиж байна уу?" гэсэн асуултад хариулдаг бөгөөд энэ нь жагсаалт шалгах оракул (enumeration oracle) болон Footprint-Free-ийн эсрэг нэр нууцлалыг алдагдуулах бодит эрсдэл болдог. Сайтын үүсгэлтийг хязгаарлах (throttling) нь залхуу шийдэл болох байсан бөгөөд бөөнөөр бэлтгэх (bulk-provisioning) бүтээгдэхүүнийг шууд доголдуулах байсан. Үүний оронд хандагч (principal) бүрээр зөвхөн татгалзсан давхардсан домэйны оролдлогуудыг хязгаарлаж төсөвлөдөг. Амжилттай үүссэн тохиолдлуудад энэ нь огт нөлөөлөхгүй — тиймээс та өдөржин бөөнөөр бэлтгэх боломжтой бөгөөд тандалт хийх оролдлогууд бараг тэр даруй таслан зогсоогддог.
Ажлын гурван өөр арга барилд зориулсан, ижил тодорхойлолтын гурван хэрэглэгч.
TypeScript, Python, PHP болон Go-д зориулан бүтээсэн бөгөөд тодорхойлолтыг дагаж мөрддөг тул гараар бичсэн wrapper-ийг хүлээхгүйгээр таны хэл дээр шинэ эцсийн цэг ирдэг.
WordPress сайтыг бүтээж, Node-оос өөр юу ч суулгалгүйгээр дотооддоо ажиллуулан, байршуулаарай. Zinnector® нь таны байршуулах гэж буй слоттой төслийг тань урьдчилан шалгаж — PHP хувилбар, диск, файлын тоо — илгээсний дараа биш харин өмнө нь анхааруулдаг. Мөн нэвтрэх, сайтуудын жагсаалт гаргах, байршуулах, домэйн болон DNS удирдах, имэйл үйлчилгээг унших, нөөц хуулбар хийх, зөвшөөрөгдсөн жагсаалт дахь WP-CLI-г ажиллуулах, лог хянах болон багц үйлдлүүдийг эхлүүлэх боломжтой. Үнэ төлбөргүй, MIT лицензтэй бөгөөд энэхүү нийтийн API дээр суурилсан.
Сайтууд, домэйнууд, DNS бичлэгүүд, шуудангийн хайрцгууд болон багцуудыг кодчилсон дэд бүтэц (infrastructure as code) хэлбэрээр удирдаарай. terraform apply нь хостингийг бэлтгэдэг бөгөөд таны орчнууд хэн ч тэмдэглэж аваагүй товшилтуудын дараалал биш, дахин давтах болон хянах боломжтой болно.
Серверийн хэрэгжүүлдэг төгсгөлийн цэгүүдийг яг таг тодорхойлсон, хөтчөөс уншиж, дуудах боломжтой үүсгэсэн баримт бичиг — учир нь хоёулаа ижил техникийн тодорхойлолтоос гаралтай.
Платформын ард бат бөх үйл явдлын тулгуур систем бий: төлөвийн өөрчлөлт бүр өгөгдлийн сангийн өөрчлөлттэй хамт нэгэн зэрэг атомар байдлаар Postgres дахь транзакцын outbox-д үйл явдлыг бичдэг бөгөөд реле үүнийг NATS JetStream рүү нийтэлдэг. Үйл явдлууд нь төрөлжсөн бөгөөд хувилбаржсан байна — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending болон бусад.
Төгсгөлийн цэгийг WebhookSubscription болгон бүртгүүлж, түүний хүлээн авах үйл явдлын төрлийг сонгоно уу. Нэг урсгал нь мэдэгдэл, аналитик, автоматжуулалт болон таны интеграцыг адилхан хангадаг — та бидний ашигладаг ижил үйл явдлуудыг ашиглаж байна.
Хүргэлт бүр HMAC гарын үсэгтэй тул та ямар нэгэн арга хэмжээ авахаасаа өмнө энэ нь манайхаас ирсэн эсэхийг баталгаажуулах боломжтой.
Амжилтгүй болсон хүргэлтийг хугацааны завсарлагатайгаар дахин оролдох бөгөөд оролдлого бүрийг WebhookDelivery хэлбэрээр бүртгэнэ. Бид юу илгээснийг асууж тусламжийн баг руу имэйл илгээхийн оронд хянах самбараас хүргэлтүүдийг шалгаж, дахин илгээх боломжтой.
Энэхүү суваг нь "яг нэг удаа" гэж дүр эсгэхийн оронд зориуд "дор хаяж нэг удаа" зарчмаар ажилладаг. Нийтлэх явцдаа зогссон релейн нэхэмжлэлийн түрээсийн хугацаа дуусаж, түүний үйл явдлууд дахин нийтлэгддэг. Дугтуйн таних тэмдэг дээр үндэслэн давхардлыг арилгаснаар таны хэрэглэгч бүтцийн хувьд алдаагүй ажиллах болно.
API бол хөгжүүлэгчийн түүхийн зөвхөн тал хувь нь юм. Үлдсэн хагас нь хэрэглээнд гаргах явдал юм.
API бол зөвхөн нэг хаалга юм. Энэ бол нөгөө дөрөв нь бөгөөд тус бүрийг хөгжүүлэгчийн түвшин болгон зарахын оронд багцад оруулсан болно.
Хянах самбар дахь сайтын хуудаснаас нээгдсэн, хөтөч дээрх VS Code нь уг сайтын бодит файлуудыг суурилуулсан git-тэйгээр засварлах бөгөөд засварлагч бүхэлдээ таны SFTP хандалттай ижил CageFS тусгаарлагдсан орчинд байрлана. Энэ нь ШУУД (LIVE) ажиллаж буй сайтыг засварладаг — дунд нь туршилтын (staging) хуулбар байхгүй тул таны хадгалсан файл бичигдсэн даруйдаа нийтэд нээлттэй болно, гэхдээ статик файл CDN кэшээс дөрөв хүртэлх цагийн турш үргэлжлүүлэн хүргэгдэж болзошгүй.
Үнэгүй, MIT лицензтэй бөгөөд энэхүү нийтийн API дээр суурилсан. WordPress сайтын бүтцийг үүсгэж, өөрийн төхөөрөмж дээр ажиллуулан, байршуулах гэж буй үүртэйгээ харьцуулан урьдчилсан шалгалт хийгээд — PHP хувилбар, диск, файлын тоо — байршуулна уу. Node 24 эсвэл түүнээс шинэ хувилбар шаардлагатай.
Хэрэгслийн нэгдсэн каталог бөгөөд таны аль хэдийн ашиглаж буй хиймэл оюун ухааны клиент нь хяналтын самбарын ашигладаг ижил API болон ижил зөвшөөрлөөр таны сайтууд дээр ажиллах боломжтой. Таны өөрийн клиентийн холбогддог ижил сервер нь веб засварлагчтай холбогдсон байдаг. Та өөрөөр заагаагүй бол зөвхөн унших эрхтэй.
Харилцагчийн ажилд таны нууц үг шаардлагагүй. Хэн нэгнийг имэйл хаягаар нь урихад тэд зөвхөн нэг л сайтад хандах эрх авна: тэд өөрсдийн нэрээр харагч, засварлагч эсвэл менежерийн үүргээр нэвтрэх бөгөөд бусад бүх сайт аливаа боловсруулагч ажиллахаас өмнө 404 гэж хариулна — энэ нь нэг удаагийн шалгалт биш, харин Postgres-ийн мөрийн түвшний аюулгүй байдлын бодлого болон хүсэлтийн түвшний хаалт юм. Бүртгэл эзэмшигч үүнийг ганц товшилтоор олгож, цуцлах боломжтой бөгөөд энэ нь тэдний дараагийн хүсэлтээс эхлэн хүчин төгөлдөр болно.
Бид уг платформыг байршуулсан MCP сервер байдлаар гаргаж байна: энэ нь ижил үйлдлийн каталог, RBAC болон аудитын түүхийг дахин ашигладаг engine API дээрх авсаархан протоколын адаптер юм. Claude Code, Cursor, ChatGPT, Claude Desktop эсвэл MCP дэмждэг аливаа клиентийг нэг удаа холбосноор бидний API-д нэмсэн бүх боломж автоматаар түүнд ашиглагдах боломжтой болно.
Агент нь гурван зүйлийг хүлээн авдаг: Tools (ижил API эцсийн цэгүүд, зөрүү үүсгэх зэрэгцээ логик байхгүй), Resources (арга хэмжээ авахаасаа өмнө бодит өгөгдлөөр оношлох боломжийг олгох зөвхөн унших зориулалттай сайтын төлөв байдал, тохиргоо, сүүлийн үеийн бүртгэлүүд, үзүүлэлтүүд, тасралтгүй ажиллагааны хугацаа болон KB нийтлэлүүд) болон Prompts ("diagnose this site" эсвэл "prepare a migration" гэх мэт нийтлэгдсэн ажлын урсгалын загварууд).
Аюулгүй байдал нь баталгаажуулалттай ижил зарчмаар ажилладаг: OAuth 2.1, танай байгууллагад холбогдсон токенууд болон мөрийн түвшний хамгаалалт бүхий RBAC зөвшөөрлүүд, хэрэгсэл бүрээр хязгаарлах болон хүчингүй болгох боломжтой, үйлдвэрлэлийн орчноос тусгаарлагдсан хамгаалагдсан хязгаарлагдмал орчин (sandbox). Устгах, түдгэлзүүлэх, тооцоо хийх, их хэмжээний зардал гаргах зэрэг сөрөг үр дагавартай үйлдлүүдэд тодорхой баталгаажуулалт эсвэл хүний зөвшөөрлийн бодлого шаардлагатай. Хүсэлтийн хурдны хязгаарлалт болон зардлын дээд хязгаар нь хиймэл оюун ухаанаар өдөөгдсөн төлбөртэй үйлдлүүдийг хязгаарладаг бөгөөд MCP дуудлага бүрийг таних тэмдэг, хэрэгсэл, аргумент болон үр дүнгийн хамт аудитын бүртгэлд хөтөлдөг.
Бид апп бүрийг нэг бүрчлэн нэгтгэхийн оронд протоколыг дэмждэг бөгөөд энэ нь таны хостингийн нэгтгэлийг өөрчлөхгүйгээр хиймэл оюун ухааны хэрэгслийн сонголтоо өөрчлөх боломжтой гэсэн үг юм.
Тийм ээ — энэ нь нийтлэгдсэн бөгөөд бэхжүүлсэн яг ижил системийн API юм. Хяналтын самбар, админ удирдлагын хэсэг, CLI, Terraform нийлүүлэгч, MCP сервер болон вэбхүүкүүд бүгд нэг гадаргуугийн хэрэглэгчид бөгөөд иймээс API нь удирдлагын самбараас хоцордоггүй.
Тийм. Sandbox түлхүүрүүдийг бүтээгдэхүүний түлхүүрүүдээс тусад нь олгодог бөгөөд туршилтын горимд ажилладаг: бодит төлбөр тооцоо хийгдэхгүй, бодит нөөц хуваарилалт хийгдэхгүй. CI-аа sandbox-ийн итгэмжлэл рүү чиглүүлж, хүсэлт болон хариултын бүрэн мөчлөгийг аюулгүйгээр туршина уу.
POST дээрээ Idempotency-Key илгээнэ үү. Давтах бичлэгийг шууд бус, commit хийх үед бичдэг тул дахин оролдлого нь бодитоор commit хийгдээгүй мөрөнд кэшлэгдсэн амжилтыг хэзээ ч давтахгүй бөгөөд амжилтгүй болсон хүсэлт нь түгжээгээ нэн даруй сулладаг тул таны зассан дахин оролдлого саатахгүй. Webhook хүргэлт нь зориудаар дор хаяж нэг удаа (at-least-once) байхаар хийгдсэн — өөрийн талд envelope id дээр давхардлыг арилгана уу (dedupe).
Өнөөдөр биш. API түлхүүрүүдийг байгууллага бүрээр олгодог тул хэд хэдэн харилцагч байгууллагыг хамарсан интеграц нь тус бүрдээ түлхүүр эзэмшдэг. Хэрэглэгчийн эрх бүхий этгээдийн зөвшөөрлийг мөн байгууллага бүрээр шалгадаг: нэг байгууллагад sites.create эрхтэй байх нь тусдаа, хамааралгүй байгууллагад нэвтрэх эрхийг олгохгүй, гэхдээ энэ нь тухайн байгууллагын доор байрлах байгууллагуудад хамаарна. Энэ нь зориудын шийдэл юм — энэ нь алдагдсан түлхүүрийг бүх платформоор биш, зөвхөн өөрийн байгууллага болон түүний доорх дэд байгууллагуудаар хязгаарладаг.
dev үүрэгт байгууллагын мэдээлэл харах, API түлхүүрийн удирдлага, сайтуудыг үзэх болон үүсгэх, тэдгээрийг дахин ачааллах, кэшийг цэвэрлэх, түүнчлэн тусламжийн хүсэлтийг үзэх, хариулах зэрэг үйлдлүүд багтана. Энэ нь төлбөр тооцооны хяналтыг зориуд оруулаагүй болно. Деплой хийх болон шууд нийтлэх (push-to-live) зөвшөөрлүүд үүнд багтахгүй болохыг анхаарна уу — хэрэв багийн гишүүнд эдгээр зөвшөөрөл шаардлагатай бол Developer-ийг хамгийн өргөн цар хүрээтэй техникийн үүрэг гэж үзэхийн оронд тэдгээрийг агуулсан үүргийг онооно уу.
Хүргэлтүүд нь саатлын хугацаатайгаар (backoff) дахин оролдох бөгөөд оролдлого бүрийг таны шалгаж болох WebhookDelivery хэлбэрээр бүртгэдэг. Дээд урсгалд үйл явдлууд нь өөрчлөлттэй яг ижил өгөгдлийн сангийн транзакц доторх транзакцын outbox-д бичигддэг тул хэрэглэгч (consumer) боломжгүй байх үед юу ч алдагдахгүй — унтарсан хэрэглэгч зөвхөн хоцрох бөгөөд энэ нь үүсгэгчийг (producer) хэзээ ч тасалдуулахгүй, мөн та буцаж ирснийхээ дараа хянах самбараас хүргэлтүүдийг дахин тоглуулах боломжтой.
Footprint-Free хостингийн төлбөрийн карт шаардахгүй 14 хоногийн туршилтыг эхлүүлээрэй — төлбөрийн мэдээлэл шаардлагагүй, 5 хүртэлх сайттай. Footprint-Free-ийн төлбөртэй багцууд PBN 5-ын хувьд сарын $6-оос эхэлнэ. Багц бүр мөнгөө буцаан авах 30 хоногийн баталгаа, үнэгүй шилжүүлэг болон нийлүүлэгчээс хараат бус байдлыг багтаасан болно.
Техникийн тодорхойлолтод суурилсан API, үүсгэсэн SDK-ууд, CLI, Terraform нийлүүлэгч, баталгаажуулсан вебхүүкүүд болон MCP сервер — дэлхий даяар 700,000 гаруй сайтуудад зориулж бидний бүтээсэн хостинг дээр. Картын болон төлбөрийн мэдээлэл шаардлагагүй 14 хоногийн туршилтаар эхлүүлнэ үү.
Үнэгүй эхлэхЭдгээр залгаас бүр таны WordPress сайтыг MCP сервер болгон хувиргадаг бөгөөд ингэснээр Claude, Cursor, VS Code болон бусад хиймэл оюун ухааны тусламжууд таны эрхээр нэвтэрч, зөвхөн таны хийх эрхтэй үйлдлүүдийг сайтан дээр хийх боломжтой болно.