დეველოპერებისთვის
Zinn Digital® არის API-პირველი პლატფორმა. ზუსტად ის ძრავის API, რომელიც ჩვენს სამუშაო დაფას ატარებს, თქვენც გადმოგეცემათ — ვერსიებით, სპეციფიკაციებზე დაფუძნებული და 100%-ით დოკუმენტირებული აგების დროს, გენერირებული SDK-ებით, CLI-ით, Terraform-ის პროვაიდერით, ხელმოწერილი ვებჰუკებით და ამ ყველაფრის თავზე MCP სერვერით. რითაც არ უნდა მუშაობდეთ — ტერმინალით, პაიპლაინით, მდგომარეობის ფაილით თუ AI აგენტით — პლატფორმა ყველას პასუხობს.
ჰოსტინგების უმეტესობა სამართავ პანელზე API-ს უკვე მზა პროდუქტზე ამაგრებს და ეს შესამჩნევიც არის — პანელის ფუნქციების ნახევარი იქამდეც კი ვერ აღწევს. ჩვენ ეს ყველაფერი პირიქით ავაგეთ. სამართავი პანელი, ადმინისტრატორის კონსოლი, CLI, Terraform პროვაიდერი, MCP სერვერი და თქვენი საკუთარი ინტეგრაციები — ყველა მათგანი ერთი და იმავე ძრავის API-ს იყენებს. თუ რამის გაკეთება პანელში შეგიძლიათ, მისი გაკეთება კოდითაც შეგიძლიათ.
OpenAPI სპეციფიკაცია არის ჭეშმარიტების წყარო და არცერთი ენდპოინტი არ ეშვება, სანამ ის სპეციფიკაციაში არ იქნება. ზუსტად ეს ერთი წესი უზრუნველყოფს იმას, რომ საჯარო API სრულად იყოს დოკუმენტირებული აგებისას და არა ოდესმე — აქ არ არსებობს არცერთი დაუდოკუმენტებელი კუთხე, რადგან დაუდოკუმენტებელი ენდპოინტი უბრალოდ ვერ იარსებებს.
ინტერაქტიული საცნობარო დოკუმენტაცია, ოთხი კლიენტის SDK, CLI-ის მნიშვნელოვანი ნაწილი და Terraform პროვაიდერის კარკასი გენერირებულია ზუსტად ამ ერთი სპეციფიკაციიდან. ერთი წყარო, მრავალი არტეფაქტი, რომლებიც მუდმივად სინქრონიზებულია — თქვენ არასდროს მოგიწევთ ისეთი დოკუმენტის ძებნა, რომელიც რეალიზაციას ჩამოშორდა.
ბოლო წერტილები განთავსებულია /v1 ქვეშ, გამოქვეყნებული მოძველების პოლიტიკით და ცვლილებების ჟურნალით. რაღაცის შეცვლამდე თქვენ გაფრთხილებთ წერილობით, ვიდრე ამას წარუმატებელი აწყობიდან შეიტყობთ.
სპეციფიკაციასა და რეალიზაციას შორის შეთანხმების ტესტები და OpenAPI-ის ლინტინგი თითოეულ ცვლილებაზე ეშვება. კოდსა და ხელშეკრულებას შორის აცდენა აჩერებს აგებას — შესაბამისად, სპეფიკაცია, რომლიდანაც კლიენტს გენერაციას უკეთებთ, სწორედ ის სპეციფიკაციაა, რომელსაც სერვერი რეალურად ასრულებს.
შემოსასვლელი ორი გზა არსებობს, თუმცა მათ უკან ერთიანი პრინციპი დგას. რომელსაც უნდა იყენებდეთ, იგივე ნებართვების შემოწმება და მონაცემთა ბაზის დონის იზოლაცია ვრცელდება.
გასაღებები არის ფორმატის zdk_<mode>_<prefix>_<secret>. ინახება მხოლოდ საიდუმლოს SHA-256 ჰეში — ჩვენ არ შეგვიძლია გასაღების თავიდან ჩვენება მისი გაცემის შემდეგ და ვერც ვინმე სხვა, ვინც ჩვენს მონაცემთა ბაზასთან მიაღწევს. გასაღებებს აქვთ წვდომის არეები (scopes), მათი გაუქმება შესაძლებელია და ისინი გაიცემა თითო ორგანიზაციაზე და არა თითო პიროვნებაზე.
სandbox გასაღებები გამოყოფილია პროდუქციის (production) გასაღებებისგან და მუშაობს სენდბოქსის (sandbox) რეჟიმში: რეალური ბილინგი და პროვიზიონინგი არ ხდება. თქვენს ინტეგრაციის ტესტებს შეუძლიათ API-ს „დატვირთვა“ ფულის დახარჯვისა და სერვერების აგების გარეშე.
მომხმარებლის სესიები ახდენს ავთენტიფიკაციას Keycloak-ის მიერ გაცემული JWT-ებით, რომლებიც მოწმდება რეალმის საჯარო გასაღებით და შეესაბამება იმავე Principal ობიექტს, რასაც API გასაღები. ბოლო წერტილები აკონტროლებს წვდომას გრანულარული ნებართვის გასაღებებით, როგორიცაა sites.create ან apikeys.manage, რომლებიც მოწმდება თითოეულ ორგანიზაციაზე — ერთ ორგანიზაციაში არსებული ნებართვა არ იძლევა წვდომას სხვა, დამოუკიდებელ ორგანიზაციაზე, თუმცა ის ვრცელდება მის ქვეშ ჩადგმულ ორგანიზაციებზე.
თითოეული დამქირავებლის მოთხოვნა შესრულებულია ტრანზაქციაში Postgres ორგანიზაციის სფეროთი (scope), რომელიც განსაზღვრულია პრინციპიდან გამომდინარე, ამიტომ იზოლაციას უზრუნველყოფს მონაცემთა ბაზა და არა ORM ფილტრი, რომელიც შესაძლოა ვინმეს დაავიწყდეს. ქუერისეთის (queryset) ფილტრი კვლავ რჩება როგორც დაცვის დამატებითი დონე.
API-ს README-ში ლამაზად გამოჩენა მარტივია, ხოლო რეალური ტრაფიკის პირობებში მისი გამართულად მუშაობა — რთული. ეს არის ის ნაწილები, რომლებზეც ვიზრუნეთ, რადგან სწორედ ისინი იწვევს ინტეგრაციების გათიშვას დილის სამ საათზე.
აღsaniშნავია ერთი დეტალი, რადგან ის განსაზღვრავს ჯგუფური მუშაობის ქცევას: 409 პასუხი დუბლირებულ დომენზე ნებისმიერი დამქირავებლისთვის პასუხობს შეკითხვას „არის თუ არა ეს ჰოსტნემი აქ ჰოსტირებული?“, რაც წარმოადგენს დათვლის ორაკულს და რეალურ დეანონსიმიზაციის რისკს Footprint-Free-ს წინააღმდეგ. საიტის შექმნის შეზღუდვა იქნებოდა ზარმაცი გამოსავალი და სრულად გატეხდა ჯგუფური პროვიზიონინგის პროდუქტს. ამის ნაცვლად, ბიუჯეტით იზღუდება მხოლოდ უარყოფილი დუბლირებული დომენის მცდელობები პრინციპალის მიხედვით. წარმატებული შექმნა არასდროს იტვირთება ამით — ასე რომ, შეგიძლიათ პროვიზიონინგი მთელი დღის განმავლობაში აწარმოოთ ჯგუფურად, ხოლო გამოკითხვა თითქმის მაშინვე წყდება.
ერთი და იგივე სპეციფიკის სამი მომხმარებელი, სამი განსხვავებული სამუშაო პროცესისთვის.
TypeScript, Python, PHP და Go ენებისთვის გენერირებული, სპეციფიკაციაზე დაყრდნობით, რათა ახალი ენდპოინტი თქვენს ენაზე ხელმისაწვდომი გახდეს ხელით დაწერილი დამჭერის მოლოდინის გარეშე.
WordPress საიტის აგება, მისი ლოკალურად გაშვება Node-ის გარდა არაფრის დაყენების გარეშე და მისი განთავსება. Zinnector® წინასწარ ამოწმებს თქვენს პროექტს იმ სლოტთან მიმართებით, სადაც მის განთავსებას აპირებთ — PHP-ს ვერსიას, დისკს, ფაილების რაოდენობას — და გაფრთხილებთ არა განთავსების შემდეგ, არამედ მის განთავსებამდე. ის ასევე შედის სისტემაში, აჩვენებს საიტების სიას, ანთავსებს პროექტებს, მართავს დომენებსა და DNS-ს, კითხულობს ფოსტის სერვისებს, აკეთებს სარეზერვო ასლებს, უშვებს დაშვებულ WP-CLI ბრძანებებს, აკვირდება ლოგებს და ატარებს მასობრივ ოპერაციებს. უფასოა, აქვს MIT ლიცენზია და აგებულია ამავე საჯარო API-ზე.
მართეთ საიტები, დომენები, DNS ჩანაწერები, საფოსტო ყუთები და პაკეტები როგორც ინფრასტრუქტურა კოდის სახით. terraform apply უზრუნველყოფს ჰოსტინგის პროვიზიონინგს, ხოლო თქვენი გარემოებები ხდება რეპროდუცირებადი და განხილვადი არავის მიერ ჩაწერილი კლიკების თანმიმდევრობის ნაცვლად.
გენერირებული დოკუმენტაცია, რომლის წაკითხვა და გამოძახება შეგიძლიათ ბრაუზერიდან. ის ზუსტად აღწერს სერვერის მიერ დანერგილი ენდპოინტების სტრუქტურას, რადგან ორივე ერთი და იმავე სპეციფიკაციიდანაა გენერირებული.
პლატფორმის უკან დგას მოვლენების გამძლე ხერხემალი: მდგომარეობის თითოეული ცვლილება წერს მოვლენას Postgres-ის ტრანზაქციულ outbox-ში, მონაცემთა ბაზის ცვლილებასთან ატომურად, ხოლო რელე აქვეყნებს მას NATS JetStream-ში. მოვლენები ტიპიზებული და ვერსიონირებულია — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending და სხვები.
დაარეგისტრირეთ საბოლოო წერტილი (endpoint) WebhookSubscription-ის სახით და აირჩიეთ მოვლენების ტიპები, რომლებსაც ის მიიღებს. ერთი ნაკადი ერთნაირად აწვდის მონაცემებს შეტყობინებებს, ანალიტიკას, ავტომატიზაციებსა და თქვენს ინტეგრაციას — თქვენ მოიხმარეთ ზუსტად იმავე მოვლენებს, რომლებსაც ჩვენ.
ყველა მიწოდება ხელმოწერილია HMAC-ით, რათა ქმედების განხორციელებამდე შეძლოთ იმის გადამოწმება, რომ ის ჩვენგან მოდის.
ვებჰუკების მიწოდების წარუმატებელი მცდელობები ავტომატურად განმეორდება ზრდადი დაყოვნებით და თითოეული მცდელობა იწერება როგორც WebhookDelivery. თქვენ შეგიძლიათ შეამოწმოთ და თავიდან გაგზავნოთ მიწოდებები სამართავი პანელიდან იმის ნაცვლად, რომ მისწეროთ მხარდაჭერის სამსახურს და იკითხოთ, თუ რა გავაგზავნეთ.
კონვეიერი განზრახ არის მინიმუმ-ერთხელ ტიპის და არა ზუსტად-ერთხელ ტიპის იმიტაციის მქონე. რელეს, რომელიც გამოქვეყნების პროცესში იღუპება, მოთხოვნის იჯარის ვადა ეწურება და მისი მოვლენები ხელახლა ქვეყნდება. გააკეთეთ დედუბლიკაცია კონვერტის იდენტიფიკატორზე და თქვენი მომხმარებელი სტრუქტურულად სწორი იქნება.
API დeveloper-ის ისტორიის მხოლოდ ნახევარია. მეორე ნახევარი კი გამოშვებაა.
ჩვენ პლატფორმას ჰოსტინგზე განთავსებული MCP სერვერის სახით წარმოვადგენთ: ეს არის ძრავის API-ის თავზე არსებული მსუბუქი პროტოკოლის ადაპტერი, რომელიც ხელახლა იყენებს იდენტურ მოქმედებათა კატალოგს, RBAC-ს და აუდიტის ჟურნალს. დააკავშირეთ Claude Code, Cursor, ChatGPT, Claude Desktop ან MCP-ის მხარდამჭერი ნებისმიერი კლიენტი ერთხელ და API-ში დამატებული ყველა შესაძლებლობა მისთვის ავტომატურად ხელმისაწვდომი გახდება.
აგიენტი იღებს სამ რამეს: ინსტრუმენტებს (იგივე API ბოლო წერტილებს, გადახრისგან დამცავი პარალელური ლოგიკის გარეშე), რესურსებს (მხოლოდ წასაკითხ საიტის ჯანმრთელობას, კონფიგურაციას, ბოლო ჟურნალებს, მეტრიკებს, მუშაობის დროს და KB სტატიებს, რათა ქმედებამდე რეალური მონაცემებით დაასვას დიაგნოზი) და პრომპტებს (გამოქვეყნებული სამუშაო პროცესის შაბლონებს, როგორიცაა „ამ საიტის დიაგნოსტიკა“ ან „მიგრაციის მომზადება“).
უსაფრთხოება იგივე ამბავია, რაც ავთენტიკაცია: OAuth 2.1, თქვენს ორგანიზაციასთან დაკავშირებული ტოკენები და RBAC ნებართვები უზრუნველყოფილია სტრიქონულ დონეზე უსაფრთხოებით, შემფარგლული და გაუქმებადი თითოეული ინსტრუმენტისთვის, სენდბოქსი გამოყოფილია პროდუქციული გარემოსგან. დესტრუქციული მოქმედებები — წაშლა, შეჩერება, ბილინგი, დიდი ხარჯები — მოითხოვს მკაფიო დადასტურებას ან ადამიანის მიერ დამტკიცების პოლიტიკას. სიხშირის ლიმიტები და ხარჯების ზღვრები აკონტროლებს ხელოვნური ინტელექტის მიერ ინიცირებულ ფასიან მოქმედებებს, ხოლო ყოველი MCP ზარი აუდიტ-ლოგირებულია იდენტურობით, ინსტრუმენტით, არგუმენტებითა და შედეგით.
ჩვენ მხარს ვუჭერთ პროტოკოლს და არა თითოეული აპის სათითაოდ ინტეგრირებას, რაც იმას ნიშნავს, რომ თქვენი AI ხელსაწყოების არჩევანი შეიძლება შეიცვალოს ისე, რომ თქვენი ჰოსტინგის ინტეგრაცია უცვლელი დარჩეს.
დიახ — ეს იგივე ძრავის API-ა, გამოქვეყნებული და გაძლიერებული. სამართავი პანელი, ადმინისტრატორის კონსოლი, CLI, Terraform პროვაიდერი, MCP სერვერი და ვებჰუკები ერთი და იმავე ზედაპირის მომხმარებლები არიან, რის გამოც API არ ჩამოუვარდება პანელს.
დიახ. სანდბოქსის გასაღებები გაიცემა პროდაქშენის გასაღებებისგან დამოუკიდებლად და მუშაობს ტესტურ რეჟიმში: რეალური ბილინგისა და რეალური პროვიზიონინგის გარეშე. მიუთითეთ თქვენი CI სანდბოქსის სავერიფიკაციო მონაცემებზე და უსაფრთხოდ გამოსცადეთ მოთხოვნისა და პასუხის სრული ციკლი.
გააგზავნეთ Idempotency-Key თქვენს POST მოთხოვნაში. განმეორებითი ჩანაწერი იწერება commit-ის დროს და არა inline რეჟიმში, ასე რომ, განმეორებითმა მცდელობამ არასდროს არ შეიძლება ხელახლა გაუშვას ქეშირებული წარმატებული შედეგი იმ სტრიქონისთვის, რომლის commit-იც რეალურად არ განხორციელებულა, ხოლო ჩაშლილი მოთხოვნა მყისიერად ათავისუფლებს თავის დაბლოკვას (lock), რათა თქვენი შესწორებული განმეორებითი მცდელობა არ შეყოვნდეს. Webhook-ის მიწოდება კონცეპტუალურად არის at-least-once — განახორციელეთ დედუპლიკაცია თქვენს მხარეს envelope id-ის მიხედვით.
დღეს არა. API გასაღებები გამოიცემა თითო ორგანიზაციაზე, ამიტომ რამდენიმე კლიენტ ორგანიზაციაზე გავრცელებულ ინტეგრაციას თითოეულისთვის ცალკე გასაღები აქვს. ნებართვები ასევე მოწმდება თითო ორგანიზაციისთვის მომხმარებლის ძირითადი სუბიექტების მიხედვით: ერთ ორგანიზაციაში sites.create-ის ფლობა არ იძლევა წვდომას სხვა, დამოუკიდებელ ორგანიზაციაში, თუმცა ის ვრცელდება მასში ჩადგმულ ორგანიზაციებზე. ეს განზრახ არის გაკეთებული — ის ზღუდავს კომპრომეტირებულ გასაღებს მხოლოდ საკუთარი ორგანიზაციითა და მის ქვეშ არსებული ქვედა ორგანიზაციებით და არა მთელი პლატფორმით.
დეველოპერის როლი მოიცავს ორგანიზაციის წაკითხვას, API გასაღებების მართვას, საიტების ნახვას და შექმნას, მათ გადატვირთვას, ქეშის გასუფთავებას, ასევე თიქეთების ნახვას და მათზე პასუხის გაცემას. ის მიზანმიმართულად გამორიცხავს ბილინგის კონტროლს. გაითვალისწინეთ, რომ დეპლოისა და ცოცხალ რეჟიმში გაშვების (push-to-live) ნებართვები მის შემადგენლობაში არ შედის — თუ გუნდის წევრს ესენი ესაჭიროება, მიანიჭეთ შესაბამისი როლი, ნაცვლად იმისა, რომ იფიქროთ, თითქოს დეველოპერი ყველაზე ფართო ტექნიკური როლია.
მიწოდებები მეორდება დაყოვნების ზრდის ინტერვალით (backoff) და თითოეული მცდელობა ჩაიწერება WebhookDelivery-ის სახით, რომლის შემოწმებაც შეგიძლიათ. Upstream დონეზე, მოვლენები იწერება ტრანზაქციულ outbox-ში მონაცემთა ბაზის იმავე ტრანზაქციაში, რომელშიც თავად ცვლილება, ასე რომ არაფერი იკარგება, სანამ მომხმარებელი (consumer) მიუწვდომელია — გამორთული consumer იწვევს დაყოვნებას, მაგრამ არასდროს აფერხებს producer-ს, ხოლო სისტემის აღდგენის შემდეგ შეგიძლიათ ხელახლა გააშვათ მიწოდებები მართვის პანელიდან (dashboard).
დაიწყეთ Footprint-Free Hosting-ის 14-დღიანი უფასო საცდელი პერიოდი ბარათის გარეშე — გადახდის დეტალების გარეშე, 5-მდე საიტით. ფასიანი Footprint-Free ტარიფები იწყება თვეში $6-დან PBN 5-ისთვის. თითოეულ გეგმას მოყვება 30-დღიანი თანხის დაბრუნების გარანტია, უფასო მიგრაცია და მიმწოდებელზე მიჯაჭვულობის გარეშე.
სპეციფიკაციებზე დამყარებული API, გენერირებული SDK-ები, CLI, Terraform პროვაიდერი, ხელმოწერილი ვებჰუქები და MCP სერვერი — ჰოსტინგზე, რომელიც მსოფლიოში 650 000-ზე მეტი საიტისთვის შევქმენით. დაიწყეთ 14-დღიანი უფასო საცდელი პერიოდი ბარათის გარეშე, გადახდის დეტალების მითითების საჭიროების გარეშე.
უფასოდ დაწყება