Әзірлеушілер үшін
Zinn Digital® — бұл API-first платформасы. Біздің басқару тақтамыздың жұмысын қамтамасыз ететін дәл сол қозғалтқыш API сізге де қолжетімді — ол нұсқаланған, спецификацияға негізделген және құрастыру кезінде 100% құжатталған, сонымен қатар оның негізінде жасалған SDK-лармен, CLI-мен, Terraform провайдерімен, қол қойылған вебхуктармен және MCP серверімен қамтамасыз етілген. Жұмыс үшін нені пайдалансаңыз да — терминалды, конвейерді, күй файлын немесе жасанды интеллект агентін болсын — платформа оған жауап береді.
Көптеген хостингтер басқару тақтасына API-ді кейіннен қоса салады және бұл бірден байқалады — тақта мүмкіндіктерінің жартысы сыртқа мүлде шықпайды. Біз мүлдем басқа жолмен жасадық. Бақылау тақтасы, әкімші консолі, CLI, Terraform провайдері, MCP сервері және жеке интеграцияларыңыз бірдей қозғалтқыш API-ін пайдаланады. Егер сіз оны тақтада жасай алсаңыз, код арқылы да жасай аласыз.
OpenAPI спецификациясы шынайылықтың жалғыз көзі болып табылады және спецификацияда көрсетілмеген ешбір соңғы нүкте шығарылмайды. Дәл осы жалғыз ереже жалпыға қолжетімді 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 сүзгісі әлі де сақталған.
API-ді README файлында әдемі етіп көрсету оңай, бірақ оның нақты трафик кезінде дұрыс жұмыс істеуін қамтамасыз ету қиын. Біз ең көп тер төккен бөліктер – дәл осылар, себебі түнгі сағат үште интеграцияларды бұзатын да солар.
Жаппай жұмыстың қалай орындалатынын анықтайтын ескерерлік бір мәлімет: қайталанатын домен бойынша 409 қатесі кез келген жалға алушы үшін «бұл хост атауы осында орналастырылған ба?» деген сұраққа жауап береді, бұл enumeration oracle болып табылады және Footprint-Free үшін нақты деанонимизация қаупін тудырады. Сайттарды құруды тежеу (throttling) оңай әрі жай ғана уақытша амал болар еді және жаппай жасақтау өнімін толығымен бұзар еді. Оның орнына, әрбір субъект (principal) бойынша тек қабылданбаған қайталанатын домен әрекеттері ғана лимитке есептеледі. Сәтті құрулар ешқашан одан шегерілмейді — сондықтан сіз күні бойы жаппай жасақтай аласыз, ал тексеру әрекеттері бірден дерлік тоқтатылады.
Жұмыстың үш түрлі тәсіліне арналған, бірдей спецификацияның үш тұтынушысы.
TypeScript, Python, PHP және Go үшін жасалған, сипаттаманы қадағалайды, сондықтан жаңа соңғы нүкте қолмен жазылған орауышты күтпей-ақ сіздің тіліңізде қолжетімді болады.
WordPress сайтын құрылымдаңыз, оны Node-тан басқа ештеңе орнатпай-ақ жергілікті орында іске қосыңыз және оны өрістетіңіз. Zinnector® жобаңызды өрістеткелі жатқан слотқа сәйкестігін — PHP нұсқасын, дискіні, файлдар санын — алдын ала тексереді және кейін емес, push жасамас бұрын ескертеді. Ол сонымен қатар жүйеге кіреді, сайттар тізімін шығарады, өрістетеді, домендер мен DNS-ті басқарады, пошта қызметтерін оқиды, сақтық көшірмелер жасайды, рұқсат етілген тізімдегі WP-CLI командаларын іске қосады, журналдарды нақты уақытта қадағалайды және жаппай әрекеттерді орындайды. Тегін, MIT лицензиясына ие және осы бірдей жалпыға қолжетімді API негізінде жасалған.
Сайттарды, домендерді, DNS жазбаларын, пошта жәшіктерін және тарифтерді код ретіндегі инфрақұрылым ретінде басқарыңыз. 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) сайтты өңдейді — арада ешқандай сынақ көшірмесі жоқ, сондықтан сақтаған файлыңыз жазылған сәттен бастап көпшілікке қолжетімді болады, дегенмен статикалық файл CDN кэшінен төрт сағатқа дейін таратылуы мүмкін.
Тегін, MIT лицензиясы бар және осы ортақ API негізінде жасалған. WordPress сайтының қаңқасын құрыңыз, оны өз құрылғыңызда іске қосыңыз, орналастырғыңыз келетін слотқа сәйкестігін алдын ала тексеріңіз — PHP нұсқасы, диск, файлдар саны — және орналастырыңыз. Node 24 немесе одан жаңа нұсқасы қажет.
Құралдардың бірыңғай каталогы, нәтижесінде сіз пайдаланып жүрген AI клиенті басқару тақтасы қолданатын сол API және сол рұқсаттар арқылы сайттарыңызда жұмыс істей алады. Жеке клиентіңіз қосылатын сервер веб-редакторға да қосылған. Басқаша көрсетпейінше тек оқуға арналған.
Клиентпен жұмыс істеу үшін құпиясөзіңіз қажет емес. Біреуді электрондық пошта мекенжайы арқылы шақырыңыз және ол нақты бір сайтқа ғана қол жеткізеді: олар өздері ретінде қараушы, редактор немесе менеджер рөлімен жүйеге кіреді, ал басқа барлық сайт кез келген өңдеуші іске қосылғанға дейін 404 жауабын береді — бұл жай ғана бір тексеру емес, Postgres жол деңгейіндегі қауіпсіздік саясаты және сұрау деңгейіндегі қоршау. Тіркелгі иесі оны бір рет басу арқылы береді және қайтарып алады, бұл олардың келесі сұрауында күшіне енеді.
Біз платформаны хостингтелген MCP сервері ретінде ұсынамыз: бұл бірдей әрекеттер каталогын, RBAC және аудит ізін қайта пайдаланатын қозғалтқыш API үстіндегі жұқа протокол адаптері. Claude Code, Cursor, ChatGPT, Claude Desktop немесе кез келген MCP қолдайтын клиентті бір рет қосыңыз, сонда біз API-ге қосатын әрбір мүмкіндік оған автоматты түрде қолжетімді болады.
Агент үш нәрсені алады: Құралдар (бірдей API түйіндері, ауытқитын параллель логикасыз), Ресурстар (әрекет жасамас бұрын нақты деректермен диагностика жасау үшін тек оқуға арналған сайт күйі, конфигурация, соңғы журналдар, көрсеткіштер, жұмыс уақыты және білім қорының мақалалары) және Нұсқаулар («осы сайтқа диагностика жасау» немесе «көшіруді дайындау» сияқты жарияланған жұмыс процесінің үлгілері).
Қауіпсіздік аутентификация сияқты құрылған: OAuth 2.1, ұйымыңызға байланыстырылған токендер және жол деңгейіндегі қауіпсіздік (RLS) қолданылатын, құрал бойынша ауқымдалған әрі кері қайтарылатын RBAC рұқсаттары, өндірістік ортадан бөлектелген құмсалғыш. Жойғыш әрекеттер — жою, тоқтата тұру, есепшот ұсыну, ірі шығындар — нақты растауды немесе адам мақұлдау саясатын талап етеді. Сұраныс шектеулері мен шығын лимиттері ЖИ іске қосатын ақылы әрекеттерді шектейді, ал әрбір MCP шақыруы жеке басы, құралы, аргументтері және нәтижесімен бірге аудит журналына тіркеледі.
Біз әрбір қолданбаны жеке-жеке біріктірудің орнына хаттамаға қолдау көрсетеміз, бұл хостинг интеграциясын өзгертпей-ақ, AI құралдарын таңдауыңызды өзгертуге мүмкіндік береді дегенді білдіреді.
Иә — бұл жарияланған және күшейтілген дәл сол қозғалтқыш API-і. Бақылау тақтасы, әкімші консолі, CLI, Terraform провайдері, MCP сервері және вебхуктер — барлығы бір ортақ интерфейсті пайдаланады, сондықтан API панельден артта қалмайды.
Иә. Sandbox кілттері өндірістік кілттерден бөлек беріледі және сынақ режимінде жұмыс істейді: нақты төлем алынбайды және нақты ресурстар ұсынылмайды. CI жүйеңізді sandbox деректеріне бағыттаңыз және сұраныс пен жауаптың толық циклін қауіпсіз түрде орындаңыз.
POST сұрауыңызда Idempotency-Key жіберіңіз. Қайталау жазбасы қатарда емес, бекіту (commit) кезінде жазылады, сондықтан қайталанған әрекет іс жүзінде бекітілмеген жол үшін кэштелген сәтті нәтижені ешқашан қайталамайды, ал сәтсіз аяқталған сұрау өз құлпын дереу босатады, сол себепті түзетілген қайталау әрекетіңіз кідіртілмейді. Webhook жеткізуі әдейі «кемінде бір рет» (at-least-once) қағидатымен жасалған — өз тарапыңызда envelope id бойынша қайталануларды жойыңыз (dedupe).
Бүгін емес. API кілттері әр ұйымға жеке беріледі, сондықтан бірнеше клиенттік ұйымдарды қамтитын интеграция әрқайсысы үшін кілт ұстайды. Рұқсаттар пайдаланушы субъектілері үшін де ұйым бойынша тексеріледі: бір ұйымда sites.create болуы бөлек, байланысы жоқ ұйымға кіруге рұқсат бермейді, бірақ ол оның астында орналасқан ұйымдарға қолданылады. Бұл әдейі жасалған — ол қауіп төнген кілтті бүкіл платформаға емес, тек оның өзінің ұйымына және оның астындағы бағынысты ұйымдарға ғана шектейді.
Dev рөлі ұйымды оқуды, API кілттерін басқаруды, сайттарды қарау мен жасауды, оларды қайта іске қосуды, кэшін тазалауды және сұраныстарды қарап, жауап беруді қамтиды. Ол төлемдерді бақылауды әдейі қамтымайды. Орналастыру және негізгі жүйеге шығару рұқсаттары оған кірмейтінін ескеріңіз — егер топ мүшесіне олар қажет болса, Developer ең кең техникалық рөл деп болжаудың орнына, сол рұқсаттары бар рөлді тағайындаңыз.
Жеткізу әрекеттері біртіндеп өсетін кідіріспен (backoff) қайталанады және әрбір әрекет сіз тексере алатын WebhookDelivery ретінде жазылады. Жүйенің жоғарғы деңгейінде оқиғалар транзакциялық outbox-қа дәл сол өзгерістің дерекқор транзакциясы аясында жазылады, сондықтан тұтынушы қолжетімсіз болған кезде ештеңе жоғалмайды — істен шыққан тұтынушы тек кідіріс тудырады, бірақ өндірушінің жұмысын ешқашан бұзбайды және жүйеге қайта оралған соң бақылау тақтасынан жеткізулерді қайта жібере аласыз.
Footprint-Free хостингінің картасыз 14 күндік сынақ мерзімін бастаңыз — төлем деректері талап етілмейді, 5 сайтқа дейін. Ақылы Footprint-Free деңгейлері PBN 5 үшін айына $6-дан басталады. Әрбір жоспар 30 күндік ақшаны қайтару кепілдігін, тегін көшіруді және вендорға тәуелділіктің болмауын қамтиды.
Спецификацияға негізделген API, жасалған SDK жинақтары, CLI, Terraform провайдері, қол қойылған вебхуктер және MCP сервері — бүкіл әлем бойынша 700 000-нан астам сайт үшін біз құрған хостингте. Төлем мәліметтерінсіз, картаны қажет етпейтін 14 күндік сынақ мерзімінен бастаңыз.
Тегін бастауБұл плагиндердің әрқайсысы сіздің WordPress сайтыңызды MCP серверіне айналдырады, сондықтан Claude, Cursor, VS Code және басқа да AI көмекшілері оған сіздің ретіңізде кіріп, сізге рұқсат етілген әрекеттер шеңберінде нақты жұмыстарды атқара алады.