დეველოპერებისთვის
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 ჰეში — ჩვენ არ შეგვიძლია გაცემის შემდეგ გასაღები კვლავ გაჩვენოთ, და ეს არც ჩვენს მონაცემთა ბაზაზე წვდომის მქონე პირს შეუძლია. გასაღებებს გააჩნიათ მოქმედების არეალი, ექვემდებარება გაუქმებას და გაიცემა ორგანიზაციაზე და არა ცალკეულ პირზე.
Sandbox-ის გასაღებები განცალკევებულია საწარმოო გასაღებებისგან და მუშაობს sandbox რეჟიმში: არანაირი რეალური ბილინგი, არანაირი რეალური რესურსების გამოყოფა. თქვენს ინტეგრაციულ ტესტებს შეუძლიათ ინტენსიურად დატვირთონ API ფულის დახარჯვისა და სერვერების აგების გარეშე.
მომხმარებლის სესიების აუთენტიფიკაცია ხდება Keycloak-ის მიერ გაცემული JWT-ებით, რომლებიც მოწმდება realm-ის საჯარო გასაღებით, და გარდაიქმნება იმავე Principal ობიექტად, როგორც API გასაღები. ბოლო წერტილებზე წვდომა იზღუდება დეტალური ნებართვის გასაღებებით, როგორიცაა sites.create ან apikeys.manage, რომლებიც მოწმდება თითოეული ორგანიზაციის მიხედვით — ერთ ორგანიზაციაში არსებული ნებართვა არ ანიჭებს წვდომას ცალკეულ, დაუკავშირებელ ორგანიზაციაში, თუმცა ის ვრცელდება მის ქვეშ ჩაშენებულ ორგანიზაციებზე.
მოიჯარის თითოეული მოთხოვნა სრულდება ტრანზაქციაში, სადაც Postgres ორგანიზაციის არეალი განსაზღვრულია ძირითადი სუბიექტის მიხედვით, ამიტომ იზოლაცია უზრუნველყოფილია მონაცემთა ბაზის მიერ და არა ORM ფილტრით, რომელიც შეიძლება ვინმეს დაავიწყდეს. Queryset ფილტრი კვლავ რჩება სიღრმისეული დაცვის სახით.
მარტივია, API კარგად გამოიყურებოდეს README-ში, მაგრამ რთულია მისი საიმედო მუშაობის უზრუნველყოფა რეალური ტრაფიკის პირობებში. სწორედ ამ ნაწილებზე ვიშრომეთ ყველაზე მეტად, რადგან სწორედ ისინი აზიანებენ ინტეგრაციებს ღამის სამ საათზე.
ერთი დეტალი, რომლის აღნიშვნაც ღირს, რადგან ის განსაზღვრავს მასობრივი ოპერაციების ქცევას: დუბლირებულ დომენზე 409 პასუხობს შეკითხვას „ჰოსტინგდება თუ არა ეს ჰოსტის სახელი აქ?“ ნებისმიერი მოიჯარისთვის, რაც წარმოადგენს enumeration oracle-ს და რეალურ დეანონიმიზაციის რისკს Footprint-Free-ის წინაშე. საიტის შექმნის შეზღუდვა (throttling) იქნებოდა მარტივი გამოსავალი და მთლიანად დააზიანებდა მასობრივი უზრუნველყოფის (bulk-provisioning) პროდუქტს. ამის ნაცვლად, მხოლოდ დუბლირებული დომენის უარყოფილი მცდელობები ითვლება ლიმიტში, თითოეულ principal-ზე. წარმატებული შექმნები ამ ლიმიტზე არასდროს აისახება — ასე რომ, შეგიძლიათ მთელი დღის განმავლობაში მასობრივად განახორციელოთ უზრუნველყოფა, ხოლო ზონდირება თითქმის მყისიერად წყდება.
ერთი და იმავე სპეციფიკაციის სამი მომხმარებელი, მუშაობის სამი განსხვავებული მეთოდისთვის.
გენერირებულია TypeScript, Python, PHP და Go-სთვის, მიჰყვება სპეციფიკაციას, რათა ახალი ბოლო წერტილი თქვენს ენაზე ხელნაწერი შეფუთვის მოლოდინის გარეშე გამოჩნდეს.
შექმენით 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. თქვენ შეგიძლიათ შეამოწმოთ და ხელახლა გაუშვათ მიწოდებები მართვის პანელიდან, იმის ნაცვლად, რომ ელფოსტით ჰკითხოთ მხარდაჭერის გუნდს, თუ რა გავაგზავნეთ.
მონაცემთა მილსადენი გამიზნულად მუშაობს „მინიმუმ ერთხელ“ პრინციპით, ნაცვლად იმისა, რომ თავი მოაჩვენოს „ზუსტად ერთხელ“ სისტემად. რელეს, რომელიც წყვეტს მუშაობას გამოქვეყნების პროცესში, მოთხოვნის იჯარის ვადა ეწურება და მისი მოვლენები ხელახლა ქვეყნდება. განახორციელეთ დედუბლიკაცია კონვერტის იდენტიფიკატორით და თქვენი მომხმარებელი კონსტრუქციულად სწორი იქნება.
API დეველოპერის ისტორიის მხოლოდ ნახევარია. მეორე ნახევარი კი გაშვებაა.
API მხოლოდ ერთი კარია. ეს არის დანარჩენი ოთხი, და თითოეული მათგანი შედის გეგმაში, ნაცვლად იმისა, რომ დეველოპერის დონედ გაიყიდოს.
VS Code ბრაუზერში, რომელიც გახსნილია მართვის პანელში არსებული საიტის გვერდიდან, არედაქტირებს ამ საიტის რეალურ ფაილებს ჩაშენებული git-ით, ხოლო მთელი რედაქტორი მოთავსებულია იმავე CageFS იზოლაციაში, რომელშიც თქვენი SFTP წვდომაა. იგი არედაქტირებს პირდაპირ (LIVE) საიტს — მათ შორის არ არსებობს სატესტო (staging) ასლი, ამიტომ თქვენ მიერ შენახული ფაილი ჩაწერისთანავე საჯარო ხდება, თუმცა სტატიკური ფაილის მიწოდება CDN ქეშიდან შეიძლება ოთხ საათამდე გაგრძელდეს.
უფასო, 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) კი გამოყოფილია ძირითადი პროდუქტიული გარემოსგან. დესტრუქციული ქმედებები — წაშლა, შეჩერება, ბილინგი, დიდი ხარჯები — მოითხოვს მკაფიო დადასტურებას ან ადამიანის მიერ დამტკიცების პოლიტიკას. მოთხოვნათა სიხშირის შეზღუდვები და ხარჯვის ლიმიტები ზღუდავს AI-ით ინიცირებულ ფასიან ქმედებებს, ხოლო თითოეული MCP გამოძახება აღირიცხება აუდიტის ჟურნალში იდენტიფიკატორის, ხელსაწყოს, არგუმენტებისა და შედეგის მითითებით.
ჩვენ მხარს ვუჭერთ პროტოკოლს, ნაცვლად თითოეული აპლიკაციის ცალ-ცალკე ინტეგრაციისა, რაც ნიშნავს, რომ თქვენი AI ინსტრუმენტების არჩევანი შეიძლება შეიცვალოს ისე, რომ მასთან ერთად ჰოსტინგის ინტეგრაცია არ შეიცვალოს.
დიახ — ეს არის იგივე ძრავის API, გამოქვეყნებული და გამაგრებული. მართვის პანელი, ადმინისტრატორის კონსოლი, CLI, Terraform პროვაიდერი, MCP სერვერი და ვებჰუკები ყველა ერთი ზედაპირის მომხმარებელია, რის გამოც API არ ჩამორჩება პანელს.
დიახ. Sandbox-ის გასაღებები გაიცემა საწარმოო გასაღებებისგან განცალკევებით და მუშაობს სატესტო რეჟიმში: არანაირი რეალური ანგარიშსწორება და არანაირი რეალური რესურსების გამოყოფა. მიმართეთ თქვენი CI sandbox-ის ავტორიზაციის მონაცემებზე და უსაფრთხოდ გამოსცადეთ მოთხოვნისა და პასუხის სრული ციკლი.
გაგზავნეთ Idempotency-Key თქვენს POST-ზე. განმეორებითი ჩანაწერი იწერება commit-ის დროს და არა ჩაშენებულად (inline), ასე რომ განმეორებითი მცდელობა ვერასდროს გაიმეორებს ქეშირებულ წარმატებას იმ მწკრივისთვის, რომელიც რეალურად არ დადასტურებულა commit-ით, ხოლო მოთხოვნა, რომელიც განიცდის მარცხს, მყისიერად ათავისუფლებს თავის დაბლოკვას (lock), რათა თქვენი გასწორებული განმეორებითი მცდელობა არ შეფერხდეს. Webhook-ის მიწოდება გამიზნულად ხორციელდება სულ მცირე ერთხელ (at-least-once) — განახორციელეთ დედუბლიკაცია თქვენს მხარეს envelope id-ის მეშვეობით.
დღეს არა. API გასაღებები გაიცემა თითოეულ ორგანიზაციაზე, ამიტომ ინტეგრაცია, რომელიც მოიცავს რამდენიმე კლიენტ ორგანიზაციას, ფლობს გასაღებს თითოეულისთვის. ნებართვები ასევე მოწმდება თითოეულ ორგანიზაციაზე მომხმარებლის ძირითადი პირებისთვის: ერთ ორგანიზაციაში sites.create-ის ფლობა არ ანიჭებს წვდომას ცალკეულ, დაუკავშირებელ ორგანიზაციაში, თუმცა ის ვრცელდება მის ქვეშ მოქცეულ ორგანიზაციებზე. ეს განზრახ არის გაკეთებული — ის ზღუდავს კომპრომეტირებულ გასაღებს მხოლოდ საკუთარ ორგანიზაციასა და მის ქვეშ მყოფ ქვედა ორგანიზაციებში, და არა მთელ პლატფორმაზე.
Dev როლი მოიცავს ორგანიზაციის მონაცემების ნახვას, API გასაღებების მართვას, საიტების დათვალიერებასა და შექმნას, მათ გადატვირთვას, მათი ქეშის გასუფთავებას, ასევე ბილეთების ნახვასა და მათზე პასუხის გაცემას. ის შეგნებულად გამორიცხავს ანგარიშსწორების მართვას. გაითვალისწინეთ, რომ დეპლოისა და პირდაპირ ეთერში გაშვების ნებართვები მის ნაწილს არ წარმოადგენს — თუ გუნდის წევრს ეს უფლებები სჭირდება, მიანიჭეთ როლი, რომელიც მათ შეიცავს, ნაცვლად იმისა, რომ Developer ყველაზე ფართო ტექნიკურ როლად მიიჩნიოთ.
მიწოდებები მეორდება შეფერხებით (backoff) და თითოეული მცდელობა აღირიცხება როგორც WebhookDelivery, რომლის შემოწმებაც შეგიძლიათ. ზედა ნაკადში (upstream), მოვლენები იწერება ტრანზაქციულ outbox-ში იმავე მონაცემთა ბაზის ტრანზაქციაში, რომელშიც თავად ცვლილებაა, ამიტომ არაფერი იკარგება, სანამ მომხმარებელი (consumer) მიუწვდომელია — გათიშული მომხმარებელი აყოვნებს, ის არასდროს აფერხებს მწარმოებელს (producer), და დაბრუნების შემდეგ შეგიძლიათ მიწოდებების ხელახლა გაშვება მართვის პანელიდან.
დაიწყეთ Footprint-Free ჰოსტინგის 14-დღიანი საცდელი პერიოდი საბანკო ბარათის გარეშე — გადახდის მონაცემების მითითების გარეშე, 5 საიტამდე. ფასიანი Footprint-Free ტარიფები იწყება თვეში 6 აშშ დოლარიდან PBN 5 პაკეტისთვის. თითოეულ გეგმას მოჰყვება თანხის დაბრუნების 30-დღიანი გარანტია, უფასო მიგრაცია და მიმწოდებელზე დამოკიდებულების (vendor lock-in) არარსებობა.
სპეციფიკაციაზე დაფუძნებული API, გენერირებული SDK-ები, CLI, Terraform პროვაიდერი, ხელმოწერილი ვებჰუკები და MCP სერვერი — ჰოსტინგზე, რომელიც მსოფლიოს მასშტაბით 700 000-ზე მეტი საიტისთვის შევქმენით. დაიწყეთ 14-დღიანი საცდელი პერიოდით ბარათისა და გადახდის დეტალების გარეშე.
დაიწყეთ უფასოდამ პლაგინებიდან თითოეული თქვენს WordPress საიტს აქცევს MCP სერვერად, რათა Claude, Cursor, VS Code და სხვა AI ასისტენტებმა შეძლონ მასზე რეალური სამუშაოს შესრულება, როგორც თქვენ ხართ შესული და შეზღუდული იმით, რისი უფლებაც გაქვთ.