Хөгжүүлэгчдэд зориулсан
Zinn Digital® бол API-тэргүүлэх чиглэлтэй платформ юм. Манай хяналтын самбарыг ажиллуулдаг ижил хөдөлгүүрийн API нь таны авч болох зүйл юм — хувилбартай, үзүүлэлт-тэргүүлэх болон бүтээх үед 100% баримтжуулсан, үүсгэсэн SDK-ууд, CLI, Terraform үйлчилгээ үзүүлэгч, гарын үсэг зурсан вэбхүүкүүд болон үүний дээрх MCP сервертэй. Таны ажиллахдаа ашигладаг ямар ч зүйл — терминал, дамжуулах шугам, төлөвийн файл эсвэл хиймэл оюун ухааны агент — платформ үүнд хариу өгдөг.
Ихэнх хостинг үйлчилгээ үзүүлэгчид удирдлагын самбартаа API-г дараа нь нэмж суулгадаг бөгөөд энэ нь ч анзаарагддаг — самбарын функцүүдийн тал нь хэзээ ч ил гардаггүй. Харин бид эсрэгээр нь бүтээсэн. Хяналтын самбар, админы консол, CLI, Terraform үйлчилгээ үзүүлэгч, MCP сервер болон таны өөрийн интеграцчилал зэрэг нь бүгд ижил хөдөлгүүрийн API-г ашигладаг. Хэрэв та үүнийг самбар дээр хийж чадах бол кодоор ч хийх боломжтой.
OpenAPI тодорхойлолт бол үнэний эх сурвалж бөгөөд уг тодорхойлолтод ороогүй бол ямар ч төгсгөл цэг гарахгүй. Энэхүү ганц дүрэм нь нийтийн API-г хожим биш харин бүтээх явцад нь бүрэн баримтжуулсан байх боломжийг олгодог бөгөөд баримтжуулаагүй нэг ч хэсэг үлдэхгүй, учир нь баримтжуулаагүй төгсгөл цэг орших боломжгүй юм.
Интерактив лавлах баримт бичгүүд, дөрвөн клиент SDK, CLI-ийн ихэнх хэсэг болон Terraform үйлчилгээ үзүүлэгчийн бүтцийг бүгдийг нь уг ганц тодорхойлолтоос үүсгэдэг. Нэг эх сурвалж, олон бүтээгдэхүүн, үргэлж нэг синхрончлолтой байх тул та хэрэгжүүлэлтээсээ хоцорсон баримт бичгийг хэзээ ч хөөцөлдөхгүй.
Төгсгөл цэгүүд нь нийтлэгдсэн хуучирсан бодлого болон өөрчлөлтийн бүртгэлтэйгээр /v1 дор ажилладаг. Ямар нэгэн зүйл өөрчлөгдөхөөс өмнө та бүтэлгүйтсэн бүтээлтэй тулгарах замаар биш, харин бичгээр урьдчилан мэдэгдэл авах болно.
Өөрчлөлт бүрийн үед хэрэгжилт болон тодорхойлолтын гэрээний тестүүд болон OpenAPI линтинг ажилладаг. Код болон гэрээний хоорондох зөрүү нь бүтээлтийг амжилтгүй болгодог — тиймээс таны үйлчлүүлэгчийг үүсгэж буй тодорхойлолт нь сервер бодит байдал дээр мөрддөг тодорхойлолт юм.
Нэвтрэх хоёр арга, гэхдээ тэдгээрийн цаана нэгэн ижил зарчим үйлчилнэ. Та алиныг нь ч ашигласан ижил зөвшөөрлийн шалгалт болон өгөгдлийн сангийн түвшний тусгаарлалт хэрэгжинэ.
Түлхүүрүүд нь zdk_<mode>_<prefix>_<secret> хэлбэртэй байна. Нууц үгийн зөвхөн SHA-256 хэш л хадгалагддаг бөгөөд бид түлхүүрийг үүсгэсний дараа дахин харуулах боломжгүй бөгөөд манай өгөгдлийн санд хандсан хэн ч үүнийг харах боломжгүй юм. Түлхүүрүүд нь хамрах хүрээтэй байдаг, хүчингүй болгох боломжтой ба хүн бүрийн хувьд биш харин байгууллага тус бүрээр олгогддог.
Туршилтын түлхүүрүүд нь үндсэн үйлдвэрлэлийн түлхүүрүүдээс тусдаа бөгөөд туршилтын горимд ажилладаг: бодит төлбөр тооцоо гарахгүй, бодит үйлчилгээ үзүүлэхгүй. Таны интеграцийн тестүүд мөнгө зарцуулахгүйгээр эсвэл сервер бүтээхгүйгээр API-г хүссэнээрээ шалгах боломжтой.
Хэрэглэгчийн сессүүд нь Keycloak-аас олгосон JWT-г ашиглан баталгаажиж, realm-ийн нийтийн түлхүүрээр шалгагдах ба API түлхүүрийн адил Principal объект болж хувирна. Төгсгөлийн цэгүүд нь байгууллага бүрээр шалгагддаг sites.create эсвэл apikeys.manage гэх мэт нарийн түвшний эрхийн түлхүүрүүдээр хандалтыг хязгаарладаг бөгөөд нэг байгууллага дахь эрх нь тусдаа, холбоогүй өөр байгууллагад хандах эрх олгохгүй, харин түүний дотор байрлах дэд байгууллагуудад үйлчилнэ.
Tenant бүрийн хүсэлт нь principal-аас тохируулсан Postgres org хүрээ бүхий гүйлгээнд ажилладаг тул тусгаарлалтыг хэн нэгний мартаж магадгүй ORM шүүлтүүрээр бус, өгөгдлийн сангаар хангадаг. Queryset шүүлтүүр нь хамгаалалтын давхаргын хувьд хэвээр байгаа.
API нь README дээр сайхан харагдахад амархан боловч бодит траффикийн үед хэвийн ажиллахад хэцүү байдаг. Интеграцыг шөнийн гурван цагт эвддэг зүйлс бол яг л бидний анхаарч ажилласан хэсгүүд юм.
Бөөнөөр ажиллах явдалд хэрхэн нөлөөлдөг тул онцолж хэлэх нэг чухал зүйл бол давхардуулсан домэйн дээрх 409 нь ямар ч түрээслэгчийн хувьд "энэ хост нэр энд байрладаг уу?" гэдэгт хариулдаг бөгөөд энэ нь тоолох оракл ба Footprint-Free-ийн эсрэг бодит де-анонимизацийн эрсдэл юм. Сайтын үүсгэлтийг хязгаарлах нь залхуу арга байх бөгөөд бөөнөөр хангах бүтээгдэхүүнийг шууд эвдэх байв. Үүний оронд зөвхөн татгалзсан давхар домэйн оролдлогод үндсэн нэгжээр хязгаарлалт тогтоодог. Амжилттай үүсгэлтүүдэд хэзээ ч тооцогдохгүй — тиймээс та өдөржин бөөнөөр хангах боломжтой бөгөөд шалгах оролдлого бараг тэр даруй зогсоно.
Ажлын гурван өөр арга барилд зориулсан, ижил үзүүлэлттэй гурван хэрэглэгч.
TypeScript, Python, PHP болон Go хэлнүүдэд зориулагдсан бөгөөд гараар бичсэн хувилбарыг хүлээлгүйгээр шинэ төгсгөл (endpoint) таны хэл дээр шууд бий болохын тулд спецификацийн дагуу шинэчлэгддэг.
WordPress сайт үүсгэж, Node-оос өөр юу ч суулгалгүйгээр локал орчинд ажиллуулж, байршуулна уу. Zinnector® нь таны төслийг байршуулах гэж буй слоттойгоо (PHP хувилбар, диск, файлын тоо) нийцэж байгаа эсэхийг урьдчилан шалгаж, орсны дараа биш харин түлхэхээс өмнө анхааруулдаг. Мөн энэ нь нэвтрэх, сайтуудын жагсаалтыг гаргах, байршуулах, домэйн болон DNS удирдах, имэйл үйлчилгээ унших, нөөц хуулбар хийх, зөвшөөрөгдсөн WP-CLI ажиллуулах, лог хянах, бөөнөөр үйлдэл хийх боломжийг олгодог. Үнэгүй, MIT лицензтэй бөгөөд энэхүү нийтийн API дээр суурилсан.
Вэбсайт, домэйн, DNS бичлэг, шуудангийн хайрцаг болон багцуудыг дэд бүтэц болгож код хэлбэрээр удирдаарай. terraform apply нь хостинг үйлчилгээг бэлтгэж, таны орчин хэн ч тэмдэглэж үлдээгээгүй дараалсан товшилтууд биш харин хуулбарлах боломжтой, хянан шалгах боломжтой зүйл болж хувирна.
Сервер дээр хэрэгжүүлсэн төгсгөлүүдийг яг таг дүрсэлсэн, хөтөч дээрээс уншиж, дуудах боломжтой үүсгэсэн баримт бичиг — учир нь хоёулаа нэг тодорхойлолтоос үүссэн.
Платформын ар талд бат бөх үйл явдлын гол нуруу ажилладаг: төлөвийн өөрчлөлт бүр өгөгдлийн сангийн өөрчлөлттэй атом байдлаар Postgres дахь гүйлгээний хайрцагт үйл явдлыг бичиж, реле үүнийг NATS JetStream руу нийтэлдэг. Үйл явдлууд нь төрөлжсөн бөгөөд хувилбартай байдаг — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending болон бусад.
WebhookSubscription болгон төгсгөл цэгийг бүртгэж, түүний хүлээн авах үйл явдлын төрлийг сонгоно уу. Нэг урсгал нь мэдэгдэл, аналитик, автоматжуулалт болон таны интеграцчлалд нэгэн зэрэг үйлчилдэг бөгөөд та бидний ашигладагтай яг ижил үйл явдлуудыг ашиглаж байна.
Хүргэлт бүр HMAC гарын үсэгтэй байдаг тул та үүнийг хэрэгжүүлэхээсээ өмнө манайхаас ирсэн эсэхийг баталгаажуулах боломжтой.
Амжилтгүй болсон хүргэлтүүдийг экспоненциал хугацааны сааталтайгаар дахин оролдох бөгөөд оролцоо бүр WebhookDelivery хэлбэрээр бүртгэгдэнэ. Та бидний юу илгээснийг асууж дэмжлэг үзүүлэх баг руу имэйл бичихийн оронд хяналтын самбараас хүргэлтүүдийг шалгаж, дахин тоглуулах боломжтой.
ЭЭнэхүү конвейер нь яг нэг удаа ажилладаг дүр эсгэхээс илүүтэйгээр дор хаяж нэг удаа ажиллахаар зориудаар бүтээгдсэн. Нийтлэлтийн явцад гэнэт унтарсан дамжуулагчийн нэхэмжлэлийн түрээсийн хугацаа дуусч, түүний үйл явдлууд дахин нийтлэгддэг. Конверт ID дээр үндэслэн давхардлыг арилгаснаар таны хэрэглэгч үндсээрээ зөв ажиллах болно.
API бол хөгжүүлэгчийн түүхэн тал нь юм. Нөгөө тал нь хүргэлт юм.
API бол нэг үүд юм. Эдгээр нь бусад дөрөв нь бөгөөд тэдгээрийн нэг бүр нь хөгжүүлэгчийн түвшин болгон зарагдахын оронд багцад багтсан болно.
Хяналтын самбар дээрх сайтын хуудаснаас нээгдсэн хөтөч дэх VS Code нь git суулгасан бөгөөд таны SFTP хандалттай ижил CageFS шоронд бүх засварлагч байрлах ба уг сайтын бодит файлуудыг засварладаг. Энэ нь ШУУД дамжиж буй сайтыг засварладаг — хооронд нь ямар нэгэн туршилтын хуулбар байхгүй тул таны хадгалсан файл бичигдмэгцээ олон нийтэд ил харагдана.
Үнэ төлбөргүй, MIT лицензтэй бөгөөд энэхүү ижил олон нийтийн API дээр бүтээгдсэн. WordPress сайтын бүтцийг үүсгэж, өөрийн машин дээр ажиллуулан, байршуулах гэж буй слот руугаа оруулахаасаа өмнө PHP хувилбар, диск, файлын тоо зэргийг шалгаад байршуулаарай. Node 24 эсвэл түүнээс шинэ хувилбар шаардлагатай.
Таны аль хэдийн ашигладаг хиймэл оюун ухааны үйлчлүүлэгч хяналтын самбарын ашигладаг ижил API болон ижил зөвшөөрлөөр таны сайтууд дээр ажиллах боломжтой болгох нэг хэрэгслийн каталог. Таны өөрийн үйлчлүүлэгчийн холбогддог ижил сервер нь вэб засварлагчтай холбогдсон сервер мөн. Таныг өөрөөр хэлтэл зөвхөн унших горимтой байна.
Үйлчлүүлэгчийн ажлыг хийхэд таны нууц үг шаардлагагүй. Хэн нэгнийг имэйл хаягаар нь урихад тэд яг нэг сайттай болох ба өөрийн нэрээр, үзэгч, засварлагч эсвэл менежерийн эрхтэйгээр нэвтэрдэг бөгөөд ямар нэгэн шалгагч ажиллахаас өмнө бусад бүх сайт 404 алдаа буцаана. Энэ нь ганц шалгалт биш, харин Postgres мөрийн түвшний аюулгүй байдлын бодлого болон хүсэлтийн түвшний хаалт юм. Бүртгэл эзэмшигч нь нэг товшилтоор эрхийг олгож, цуцлах ба энэ нь тэдний дараагийн хүсэлтээс эхлэн үйлчилнэ.
Бид уг платформыг хост хийгдсэн MCP серверийн хэлбэрээр буюу хөдөлгүүрийн API дээрх нимгэн протокол адаптер хэлбэрээр гаргаж өгдөг бөгөөд энэ нь яг ижил үйлдлийн каталог, RBAC болон аудитын мөрийг дахин ашигладаг. Claude Code, Cursor, ChatGPT, Claude Desktop эсвэл MCP ажиллах ямар ч клиентийг нэг удаа холбоход л API дээр нэмсэн бүхий л боломж автоматаар түүнд ашиглагдах болно.
Агент гурван зүйлийг хүлээн авдаг: Хэрэгслүүд (ижил API төгсгөлийн цэгүүд, зөрөх зэрэгцээ логик байхгүй), Нөөцүүд (бодит өгөгдөл дээр тулгуурлан ажиллахын тулд сайт эрүүл мэнд, тохиргоо, сүүлийн үеийн логууд, хэмжигдэхүүнүүд, ажиллах хугацаа болон МБ-ын нийтлэлүүдийг зөвхөн унших горимоор хардаг) болон Сануулгууд ("энэ сайтыг оношлох" эсвэл "шилжилт суурьшилд бэлтгэх" гэх мэт нийтлэгдсэн ажлын урсгалын загварууд).
Аюулгүй байдал нь баталгаажуулалттай ижил зарчимтай: OAuth 2.1, танай байгууллагад холбосон токенууд болон мөрний түвшний аюулгүй байдлыг хангасан RBAC эрхүүд, хэрэгсэл бүрээр хязгаарлах болон цуцлах боломжтой, сургалтын орчин (sandbox) нь үйлдвэрлэлийн орчноос тусгаарлагдсан. Устгах, түдгэлзүүлэх, төлбөр тооцоо, их хэмжээний зарцуулалт зэрэг сөрөг үр дагавартай үйлдлүүдэд тодорхой зөвшөөрөл эсвэл хүний баталгаажуулалтын бодлого шаардлагатай. Хурдны хязгаарлалт болон зарцуулалтын дээд хэмжээ нь хиймэл интеллектээс үүдэлтэй төлбөртэй үйлдлүүдийг хязгаарладаг бөгөөд MCP дуудлага бүрийг хэн хийсэн, ямар хэрэгсэл, аргумент болон үр дүнтэй нь аудит хийн бүртгэдэг.
Бид апп бүрийг нэг бүрчлэн нэгтгэхийн оронд протоколыг нь дэмждэг тул таны хостинг интеграци өөрчлөгдөхгүйгээр таны сонгосон хиймэл оюун ухааны багаж хэрэгсэл өөрчлөгдөх боломжтой гэсэн үг юм.
Тийм ээ — энэ бол хэвлэгдсэн бөгөөд туршигдаж баталгаажсан ижил хөдөлгүүрийн API юм. Хяналтын самбар, админ консол, CLI, Terraform үйлчилгээ үзүүлэгч, MCP сервер болон вэбхүүкүүд бүгд нэг интерфейсийг ашигладаг тул API нь удирдлагын самбараас хоцрогддоггүй.
Тийм. Туршилтын түлхүүрүүдийг бүтээгдэхүүний түлхүүрүүдээс тусад нь олгодог бөгөөд туршилтын горимд ажилладаг: бодит тооцоо болон бодит нөөц хуваарилалт хийгдэхгүй. CI-гээ туршилтын эрх рүү чиглүүлж, хүсэлт болон хариуны бүтэн циклийг аюулгүйгээр туршиж үзээрэй.
POST хүсэлт дээрээ Idempotency-Key илгөэнэ үү. Дахин тоглуулах бичлэг нь шууд бус харин гүйлгээ хийгдэх үед бичигддэг тул бодитоор амжилттай хийгдээгүй мөрөнд зориулж дахин оролдлого нь кэшлэгдсэн амжилтыг хэзээ ч дахин тоглуулахгүй бөгөөд амжилтгүй болсон хүсэлт нь түгжээгээ шууд суллах тул таны засч залруулсан дахин оролдлого гацахгүй. Вэбхүүкийн хүргэлт нь бүтцийн хувьд дор хаяж нэг удаа байхаар хийгдсэн тул та өөрийн талд конвертын ID дээр үндэслэн давхардлыг арилгана уу.
Өнөөдөр биш. API түлхүүрүүд нь байгууллага тус бүрээр олгогддог тул хэд хэдэн үйлчлүүлэгчийн байгууллагыг хамарсан интеграци нь тус бүрдээ түлхүүртэй байдаг. Мөн хэрэглэгчийн эрхийн хувьд зөвшөөрлийг байгууллага тус бүрээр шалгадаг: нэг байгууллагад sites.create эрхтэй байх нь өөр, хамааралгүй байгууллагад хандах эрх олгохгүй, гэхдээ энэ нь тухайн байгууллагын дотор давхарласан дэд байгууллагуудад үйлчилнэ. Энэ бол санаатай шийдвэр бөгөөд эвдэрсэн түлхүүрийн хүрээг бүх платформ биш, зөвхөн өөрийнх нь байгууллага болон түүн доорх дэд байгууллагуудаар хязгаарладаг.
Хөгжүүлэгчийн үүрэгт байгууллагын мэдээлэл унших, API түлхүүр удирдах, сайт үзэх болон үүсгэх, тэдгээрийг дахин эхлүүлэх, кэшийг цэвэрлэх, тасалбар үзэх болон хариулах зэрэг багтана. Энэ нь төлбөр тооцооны хяналтыг санаатайгаар хассан болно. Байршуулах болон шууд ашиглалтад оруулах (push-to-live) зөвшөөрөл нь үүнд ороогүйг анхаарна уу — хэрэглэгчид эдгээр шаардлагатай бол Хөгжүүлэгч нь хамгийн өргөн хүрээтэй техникийн үүрэг гэж үзэхээс илүүтэйгээр тэдгээрийг агуулсан үүргийг онооно уу.
Хүргэлтүүд нь завсарлагатайгаар дахин оролцогддог бөгөөд оролдлого бүр нь шалгах боломжтой WebhookDelivery хэлбэрээр тэмдэглэгддэг. Дээд урсгалд үйл явдлууд нь өөрчлөлт гарсан өгөгдлийн сангийн гүйлгээтэй ижил гүйлгээнд гүйлгээний outbox руу бичигддэг тул хэрэглэгч ашиглах боломжгүй байх үед юу ч алдагдахгүй – ажиллахгүй байгаа хэрэглэгч хоцорно уу гэхээс үйлдвэрлэгчийг хэзээ ч эвддэггүй бөгөөд та буцаж ирээд хяналтын самбараас хүргэлтүүдийг дахин тоглуулах боломжтой.
Footprint-Free Hosting-ийн карт шаардахгүй 14 хоногийн туршилтыг эхлүүлнэ үү — төлбөрийн мэдээлэл шаардахгүй, 5 хүртэлх сайт. Төлбөртэй Footprint-Free багцууд PBN 5 хувьд сарын $6-аас эхэлнэ. Багц бүр 30 хоногийн мөнгө буцаан олгох баталгаа, үнэгүй шилжүүлэг болон үйлчилгээ үзүүлэгчээс хараат бус байх нөхцөлийг агуулна.
Техникийн үзүүлэлтэд суурилсан API, үүсгэсэн SDK, CLI, Terraform үйлчилгээ үзүүлэгч, гарын үсэг зурсан вебхүүк болон MCP сервер — дэлхий даяарх 650,000+ сайтын төлөө бидний бүтээсэн хостинг дээр. Төлбөрийн мэдээлэл шаардахгүй, картгүйгээр 14 хоног үнэгүй туршиж эхлээрэй.
Үнэгүй эхлэх