Tərtibatçılar üçün
Zinn Digital® ilk növbədə API əsaslı platformadır. İdarəetmə panelimizi işlədən eyni mühərrik API-si sizin əldə etdiyinizdir — versiyalaşdırılmış, spesifikasiya əsaslı və qurulma zamanı 100% sənədləşdirilmiş, üstəlik yaradılmış SDK-lar, CLI, Terraform provayderi, imzalanmış veb-huklar və MCP serveri ilə təmin edilmişdir. İşləmək üçün nə istifadə etməyinizdən asılı olmayaraq — terminal, konveyer, vəziyyət faylı və ya süni intellekt agenti — platforma ona cavab verir.
Əksər hostinqlər API-ni idarəetmə panelinə sonradan əlavə edir və bu dərhal nəzərə çarpır — panelin funksiyalarının yarısı heç vaxt oraya çatmır. Biz isə tam əksini etdik. İdarə paneli, inzibatçı konsolu, CLI, Terraform provayderi, MCP serveri və şəxsi inteqrasiyalarınızın hamısı eyni mühərrik API-sindən istifadə edir. Paneldə edə bildiyiniz hər şeyi kod vasitəsilə də edə bilərsiniz.
OpenAPI spesifikasiyası həqiqət mənbəyidir və spesifikasiyada olmadığı təqdirdə heç bir son nöqtə təqdim edilmir. Məhz bu tək qayda ictimai API-nin sonradan deyil, qurulma zamanı tam sənədləşdirilməsini təmin edir — heç bir sənədləşdirilməmiş tərəf yoxdur, çünki sənədləşdirilməmiş son nöqtə mövcud ola bilməz.
İnteraktiv istinad sənədləri, dörd müştəri SDK-sı, CLI-nin böyük bir hissəsi və Terraform provayder skeleti hamısı həmin tək spesifikasiyadan yaradılır. Bir mənbə, çoxlu artefaktlar, həmişə sinxron — siz heç vaxt tətbiqdən kənara çıxmış sənədin arxasınca düşmürsünüz.
Son nöqtələr dərc olunmuş köhnəlmə siyasəti və dəyişikliklər jurnalı ilə birlikdə /v1 altında yerləşir. Dəyişiklik baş verməzdən əvvəl uğursuz quraşdırma vasitəsilə öyrənmək əvəzinə, sizə yazılı şəkildə məlumat verilir.
Hər bir dəyişiklikdə icra ilə spesifikasiya arasındakı müqavilə testləri və OpenAPI yoxlaması (linting) işə salınır. Kod ilə müqavilə arasındakı uyğunsuzluq qurulmanı dayandırır — beləliklə, müştərinizi generasiya etdiyiniz spesifikasiya serverin faktiki olaraq riayət etdiyi spesifikasiyadır.
İki giriş yolu, onların arxasında vahid bir prinsip. Hansını istifadə etsəniz də, eyni icazə yoxlamaları və eyni verilənlər bazası səviyyəsində təcrid tətbiq olunur.
Açarlar zdk_<mode>_<prefix>_<secret> kimi görünür. Gizli açarın yalnız SHA-256 heşi saxlanılır — açar verildikdən sonra onu sizə yenidən göstərə bilmərik və verilənlər bazamıza daxil olan heç kim də bunu edə bilməz. Açarlar əhatə dairələrinə malikdir, ləğv edilə bilər və ayrı-ayrı şəxslər üçün deyil, təşkilat üzrə verilir.
Sandbox açarları production açarlarından ayrıdır və sandbox rejimində işləyir: real ödəniş yoxdur, real resurs təminatı yoxdur. İnteqrasiya testləriniz pul xərcləmədən və ya serverlər qurmadan API-yə intensiv sorğular göndərə bilər.
İstifadəçi sessiyaları Keycloak tərəfindən verilmiş JWT-lərlə autentifikasiya olunur, mühitin (realm) açıq açarı ilə yoxlanılır və API açarının həll etdiyi eyni Principal obyektinə yönləndirilir. Son nöqtələr sites.create və ya apikeys.manage kimi təfsilatlı icazə açarları ilə məhdudlaşdırılır və hər təşkilat üzrə yoxlanılır — bir təşkilatdakı icazə, tabeliyindəki alt təşkilatlara şamil edilsə də, ayrıca, əlaqəsi olmayan başqa bir təşkilatda heç bir giriş hüququ vermir.
Hər bir icarəçi sorğusu əsas istifadəçidən təyin edilmiş Postgres təşkilat əhatəsi ilə bir tranzaksiya daxilində işləyir, beləliklə, təcrid kimsə tərəfindən unudula biləcək ORM filtri ilə deyil, verilənlər bazası tərəfindən təmin edilir. Queryset filtri isə dərinləşdirilmiş müdafiə məqsədilə hələ də mövcuddur.
API-ni README sənədində yaxşı göstərmək asandır, lakin real trafik altında etibarlı işləməsini təmin etmək çətindir. Bunlar üzərində ən çox zəhmət çəkdiyimiz hissələrdir, çünki gecə saat üçdə inteqrasiyaları sıradan çıxaran məhz bu detallardır.
Toplu işin necə işlədiyini formalaşdırdığı üçün qeyd etməyə dəyər bir detal: dublikat domen üzrə 409 xətası istənilən icarəçi üçün "bu host adı burada yerləşdirilibmi?" sualına cavab verir ki, bu da sıralama orakulu (enumeration oracle) və Footprint-Free üçün real deanonimləşdirmə riskidir. Sayt yaradılmasını məhdudlaşdırmaq (throttling) asan bir çıxış yolu olardı və toplu təminat məhsulunu tamamilə sıradan çıxarardı. Bunun əvəzinə, yalnız rədd edilmiş dublikat domen cəhdləri hər bir əsas istifadəçi üzrə limitləşdirilir. Uğurlu yaradılmalar heç vaxt bu limitə daxil edilmir — beləliklə, bütün gün toplu şəkildə təminat verə bilərsiniz və yoxlama cəhdləri dərhal dayanır.
Üç fərqli iş tərzi üçün eyni spesifikasiyanın üç istehlakçısı.
TypeScript, Python, PHP və Go üçün tərtib edilmişdir; spesifikasiyanı izləyir, beləliklə, əl ilə yazılmış örtüyü gözləmədən yeni son nöqtə dilinizə çatır.
Bir WordPress saytının strukturunu qurun, Node-dan başqa heç nə quraşdırmadan onu lokal olaraq işə salın və yerləşdirin. Zinnector® layihənizi yerləşdirəcəyiniz slot üzrə — PHP versiyası, disk, fayl sayı — öncədən yoxlayır və göndərmədən (push) sonra deyil, əvvəl xəbərdarlıq edir. O, həmçinin daxil olur, saytları siyahıya alır, yerləşdirir, domenləri və DNS-i idarə edir, poçt xidmətlərini oxuyur, ehtiyat nüsxələrini çıxarır, icazə verilən WP-CLI əmrlərini icra edir, loqları izləyir və kütləvi əməliyyatları başladır. Pulsuz, MIT lisenziyalı və məhz bu ümumi API üzərində qurulmuşdur.
Saytları, domenləri, DNS qeydlərini, poçt qutularını və planları kod kimi infrastruktur olaraq idarə edin. terraform apply hostinqi təmin edir və mühitləriniz heç kimin qeyd etmədiyi kliklər ardıcıllığı əvəzinə təkrar istehsal edilə bilən və nəzərdən keçirilə bilən olur.
Serverin icra etdiyi son nöqtələri dəqiqliklə təsvir edən, brauzerdən oxuya və çağıra biləcəyiniz yaradılmış sənədlər — çünki hər ikisi eyni spesifikasiyadan qaynaqlanır.
Platformanın arxasında davamlı hadisə onurğası dayanır: hər vəziyyət dəyişikliyi verilənlər bazası dəyişikliyi ilə atomik şəkildə Postgres-də tranzaksiya çıxış qutusuna bir hadisə yazır və bir rele bunu NATS JetStream-ə dərc edir. Hadisələr tipləşdirilmiş və versiyalaşdırılmışdır — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending və digərləri.
Bir son nöqtəni WebhookSubscription olaraq qeydiyyatdan keçirin və onun qəbul edəcəyi hadisə növlərini seçin. Tək bir axın bildirişləri, analitikanı, avtomatlaşdırmaları və inteqrasiyanızı eyni dərəcədə təmin edir — siz bizim istifadə etdiyimiz eyni hadisələri qəbul edirsiniz.
Hər bir çatdırılma HMAC ilə imzalanır, beləliklə, hər hansı tədbir görməzdən əvvəl onun bizdən gəldiyini təsdiqləyə bilərsiniz.
Uğursuz çatdırılmalar fasilə ilə yenidən cəhd edilir və hər cəhd WebhookDelivery kimi qeydə alınır. Nə göndərdiyimizi soruşmaq üçün dəstək xidmətinə e-poçt göndərmək əvəzinə, çatdırılmaları idarəetmə panelindən yoxlaya və yenidən göndərə bilərsiniz.
Boru kəməri tam olaraq bir dəfə olduğunu iddia etmək əvəzinə, qəsdən ən azı bir dəfə işləyəcək şəkildə qurulmuşdur. Nəşrin ortasında fəaliyyətini dayandıran releyinin iddia icarə müddəti başa çatır və hadisələri yenidən dərc olunur. Zərf identifikatoruna əsasən təkrarı aradan qaldırın və istehlakçınız konstruktiv olaraq düzgün işləyəcəkdir.
API tərtibatçı hekayəsinin yalnız yarısıdır. Digər yarısı isə təqdimatdır.
API qapılardan biridir. Digər dördü bunlardır və hər biri tərtibatçı səviyyəsi kimi satılmaq əvəzinə plana daxil edilmişdir.
İdarəetmə panelindəki sayt səhifəsindən açılan, daxili git funksiyası ilə həmin saytın real fayllarını redaktə edən və bütün redaktoru SFTP girişinizlə eyni CageFS həbsxanasında (jail) yerləşən brauzerdəki VS Code. O, CANLI saytı redaktə edir — arada heç bir sınaq (staging) nüsxəsi yoxdur, buna görə də yadda saxladığınız fayl yazıldığı andan etibarən ictimaiyyətə açıq olur, lakin statik fayl CDN keşindən dörd saata qədər yayımlanmağa davam edə bilər.
Pulsuz, MIT lisenziyalı və bu eyni açıq API üzərində qurulmuşdur. WordPress saytının strukturunu qurun, onu öz kompüterinizdə işə salın, yerləşdirəcəyiniz slot üzrə ilkin yoxlamadan keçirin — PHP versiyası, disk, fayl sayı — və yerləşdirin. Node 24 və ya daha yeni versiya tələb olunur.
Vahid alətlər kataloqu, beləliklə, artıq istifadə etdiyiniz süni intellekt müştərisi idarəetmə panelinin istifadə etdiyi eyni API və eyni icazələr vasitəsilə saytlarınızda işləyə bilər. Şəxsi müştərinizin qoşulduğu eyni server veb redaktora qoşulan serverdir. Siz başqa cür təyin edənə qədər yalnız oxumaq üçün nəzərdə tutulub.
Müştəri işi üçün parolunuz tələb olunmur. E-poçt ünvanı ilə kimisə dəvət edin və onlar dəqiq bir sayt əldə etsinlər: öz adları ilə, baxıcı, redaktor və ya idarəçi rolu ilə daxil olurlar və hər hansı işləyici işə düşməzdən əvvəl digər bütün saytlar 404 cavabını verir — təkcə bir yoxlama deyil, Postgres sətir səviyyəli təhlükəsizlik siyasəti və sorğu səviyyəli maneə mövcuddur. Hesab sahibi bunu bir kliklə təqdim edir və ləğv edir, növbəti sorğudan etibarən qüvvəyə minir.
Platformanı host edilən bir MCP serveri kimi təqdim edirik: eyni əməliyyat kataloqunu, RBAC-ı və audit izini təkrar istifadə edən mühərrik API-si üzərində incə protokol adapteri. Claude Code, Cursor, ChatGPT, Claude Desktop və ya hər hansı bir MCP dəstəkli müştərini bir dəfə qoşun və API-yə əlavə etdiyimiz hər bir imkan avtomatik olaraq onun üçün əlçatan olacaq.
Agent üç şey əldə edir: Alətlər (eyni API son nöqtələri, yayınacaq paralel məntiq yoxdur), Resurslar (hərəkətə keçməzdən əvvəl real məlumatlarla diaqnostika apara bilməsi üçün yalnız oxumaq üçün sayt sağlamlığı, konfiqurasiya, son qeydlər, metriklər, iş vaxtı və bilik bazası məqalələri) və İstiqamətlər ("bu saytı diaqnostika edin" və ya "miqrasiya hazırlayın" kimi dərc edilmiş iş axını şablonları).
Təhlükəsizlik autentifikasiya ilə eyni hekayədir: OAuth 2.1, təşkilatınızla əlaqələndirilmiş tokenlər və sətir səviyyəsində təhlükəsizlik tətbiq edilmiş RBAC icazələri, hər alət üzrə əhatə dairəsi müəyyən edilmiş və ləğv edilə bilən, istehsaldan ayrılmış sınaq mühiti (sandbox). Dağıdıcı hərəkətlər — silmə, dayandırma, hesablaşma, böyük xərclər — açıq təsdiq və ya insanın təsdiqləməsi siyasətini tələb edir. Sorğu limitləri və xərc hədləri süni intellekt tərəfindən başladılan ödənişli hərəkətləri məhdudlaşdırır və hər bir MCP çağırışı şəxsiyyət, alət, arqumentlər və nəticə ilə birlikdə audit jurnalına qeyd olunur.
Hər bir tətbiqi tək-tək inteqrasiya etmək əvəzinə protokolu dəstəkləyirik, bu da o deməkdir ki, hostinq inteqrasiyanız dəyişmədən AI alətləri seçiminiz dəyişə bilər.
Bəli — bu, dərc edilmiş və gücləndirilmiş eyni mühərrik API-sidir. İdarə paneli, inzibatçı konsolu, CLI, Terraform provayderi, MCP serveri və veb-huklar hamısı vahid səthin istehlakçılarıdır, buna görə də API paneldən geridə qalmır.
Bəli. Sandbox açarları istehsal açarlarından ayrıca verilir və sınaq rejimində işləyir: real faktura və real resurs təminatı yoxdur. CI-nızı sandbox etimadnamələrinə yönləndirin və bütün sorğu və cavab dövrünü təhlükəsiz şəkildə həyata keçirin.
POST sorğunuzda bir Idempotency-Key göndərin. Təkrar qeydi daxili deyil, commit zamanı yazılır, buna görə də təkrar cəhd heç vaxt faktiki olaraq commit edilməmiş bir sətir üçün keşlənmiş uğuru təkrar oynada bilməz və uğursuz olan sorğu kilidini dərhal buraxır ki, düzəldilmiş təkrar cəhdiniz ləngiməsin. Webhook çatdırılması dizayn baxımından ən azı bir dəfədir (at-least-once) — öz tərəfinizdə envelope id üzrə təkrarları aradan qaldırın.
Bu gün yox. API açarları hər təşkilat üçün ayrıca verilir, buna görə də bir neçə müştəri təşkilatını əhatə edən inteqrasiya onların hər biri üçün ayrıca açar saxlayır. İcazələr istifadəçi subyektləri üçün də hər təşkilata görə yoxlanılır: bir təşkilatda sites.create icazəsinə malik olmaq, həmin təşkilatın altında yerləşən təşkilatlara şamil edilsə də, ayrı və əlaqəsiz bir təşkilatda heç bir giriş hüququ vermir. Bu qəsdən belə edilib — bu, təhlükəsizliyi pozulmuş açarı bütün platformaya deyil, yalnız öz təşkilatına və onun tabeliyindəki alt təşkilatlara məhdudlaşdırır.
dev rolu təşkilat üzrə oxumağı, API açarlarının idarə edilməsini, saytlara baxışı və onların yaradılmasını, yenidən başladılmasını, keşlərinin təmizlənməsini, habelə biletlərə baxışı və cavablandırılmasını əhatə edir. Bu rol qəsdən faktura nəzarətini istisna edir. Nəzərə alın ki, yerləşdirmə və push-to-live icazələri bura daxil deyil — komanda üzvünün bunlara ehtiyacı varsa, Developer rolunun ən geniş texniki rol olduğunu güman etmək əvəzinə, bu icazələri ehtiva edən bir rol təyin edin.
Çatdırılmalar tədrici fasilə (backoff) ilə yenidən cəhd edilir və hər bir cəhd yoxlaya biləcəyiniz WebhookDelivery kimi qeydə alınır. İlkin mərhələdə, hadisələr dəyişikliyin özü ilə eyni verilənlər bazası əməliyyatında tranzaksiyalı çıxış qutusuna (transactional outbox) yazılır, buna görə də istehlakçı əlçatan olmadıqda heç bir şey itirilmir — sıradan çıxmış istehlakçı ləngiyir, heç vaxt istehsalçını sıradan çıxarmır və siz geri qayıtdıqdan sonra paneldən çatdırılmaları yenidən başlada bilərsiniz.
Footprint-Free Hostinqin kart tələb olunmayan 14 günlük sınaq versiyası ilə başlayın — ödəniş məlumatları tələb olunmur, 5-ə qədər sayt. Ödənişli Footprint-Free tarifləri PBN 5 üçün ayda $6-dan başlayır. Hər bir plana 30 günlük pulun geri qaytarılması zəmanəti, pulsuz köçürmələr və provayderdən asılılığın olmaması daxildir.
Spesifikasiya əsaslı API, generasiya edilmiş SDK-lar, CLI, Terraform provayderi, imzalanmış veb-huklar və MCP serveri — dünya üzrə 700 000-dən çox sayt üçün qurduğumuz hostinqdə. Ödəniş məlumatları tələb olunmayan, kart tələb etməyən 14 günlük sınaq müddəti ilə başlayın.
Pulsuz başlayınBu plaginlərin hər biri sizin WordPress saytınızı MCP serverinə çevirir ki, Claude, Cursor, VS Code və digər süni intellekt köməkçiləri sizin kimi daxil olaraq və yalnız sizə icazə verilən əməliyyatlarla məhdudlaşaraq onun üzərində real işlər görə bilsinlər.