विकासकर्ताहरूका लागि
Zinn Digital® एक API-प्राथमिकता प्लेटफर्म हो। हाम्रो ड्यासबोर्ड सञ्चालन गर्ने उही इन्जिन API तपाईंले प्राप्त गर्नुहुनेछ — संस्करण गरिएको, विशिष्टता-प्राथमिकता भएको र निर्माणको समयमा १००% दस्तावेजीकरण गरिएको, जसमा सिर्जना गरिएका SDK हरू, एउटा CLI, एउटा Terraform प्रदायक, हस्ताक्षरित वेबहुकहरू र यसको माथि एउटा MCP सर्भर समावेश छन्। काम गर्न तपाईं जेसुकै प्रयोग गर्नुहुन्छ — टर्मिनल, पाइपलाइन, स्टेट फाइल वा AI एजेन्ट — प्लेटफर्मले त्यसको जवाफ दिन्छ।
धेरैजसो होस्टहरूले पछि मात्र कन्ट्रोल प्यानलमा API थप्छन्, र त्यो स्पष्ट रूपमा देखिन्छ — प्यानलका आधा सुविधाहरू कहिल्यै बाहिर आउँदैनन्। हामीले भने यसको विपरीत तरिकाले निर्माण गरेका छौं। ड्यासबोर्ड, एडमिन कन्सोल, CLI, Terraform प्रदायक, MCP सर्भर र तपाईंका आफ्नै एकीकरणहरू सबैले एउटै इन्जिन API प्रयोग गर्छन्। यदि तपाईंले यसलाई प्यानलमा गर्न सक्नुहुन्छ भने, तपाईंले कोडमार्फत पनि गर्न सक्नुहुन्छ।
OpenAPI विशिष्टता सत्यको अन्तिम स्रोत हो, र जबसम्म यो विशिष्टतामा समावेश हुँदैन, तबसम्म कुनै पनि अन्तिम बिन्दु (endpoint) जारी गरिँदैन। यही एउटै नियमले सार्वजनिक API लाई पछि कहिले होइन, निर्माणकै समयमा पूर्ण रूपमा दस्तावेज गरिएको बनाउँछ — कुनै पनि अदस्तावेजी कुना हुँदैन, किनकि अदस्तावेजी अन्तिम बिन्दु अस्तित्वमा हुनै सक्दैन।
अन्तरक्रियात्मक सन्दर्भ कागजातहरू, चारवटा क्लाइन्ट SDK हरू, CLI को धेरैजसो भाग र Terraform प्रदायक मचान सबै सोही एउटा विशिष्टीकरणबाट उत्पन्न हुन्छन्। एउटै स्रोत, धेरै निर्माणहरू, सधैँ सिङ्कमा — तपाईंले कार्यान्वयनबाट फरक परेको कागजात कहिल्यै पछ्याउनु पर्दैन।
अन्त्यबिन्दुहरू प्रकाशित बहिष्करण नीति र परिवर्तन लग सहित /v1 अन्तर्गत रहेका छन्। असफल निर्माणबाट थाहा पाउनुको साटो, कुनै पनि कुरा परिवर्तन हुनुअघि तपाईंलाई लिखित रूपमा सूचित गरिन्छ।
कार्यान्वयन-बनाम-विशिष्टीकरण सम्झौता परीक्षणहरू र OpenAPI लिन्टिङ प्रत्येक परिवर्तनमा सञ्चालन हुन्छन्। कोड र सम्झौता बीचको भिन्नताले निर्माणलाई असफल बनाउँछ — त्यसैले तपाईंले आफ्नो क्लाइन्ट उत्पन्न गर्ने विशिष्टीकरण नै सर्भरले वास्तवमा पालना गर्ने विशिष्टीकरण हो।
प्रवेश गर्ने दुई तरिकाहरू, तिनीहरूको पछाडि एउटै समान सिद्धान्त। तपाईंले जुनसुकै प्रयोग गरे तापनि, उही अनुमति जाँचहरू र उही डाटाबेस-स्तरको पृथक्करण लागू हुन्छ।
कुञ्जीहरू zdk_<mode>_<prefix>_<secret> जस्ता देखिन्छन्। गोप्य कुराको SHA-256 ह्यास मात्र भण्डारण गरिन्छ — जारी गरिसकेपछि हामी तपाईंलाई फेरि कुञ्जी देखाउन सक्दैनौं, र हाम्रो डाटाबेसमा पहुँच पुर्याउने कसैले पनि सक्दैन। कुञ्जीहरूले कार्यक्षेत्रहरू बोक्छन्, खारेज गर्न सकिन्छ, र व्यक्ति अनुसार नभई संस्था अनुसार जारी गरिन्छ।
स्यान्डबक्स कुञ्जीहरू प्रोडक्सन कुञ्जीहरू भन्दा छुट्टै हुन्छन् र स्यान्डबक्स मोडमा चल्छन्: कुनै वास्तविक बिलिङ हुँदैन, कुनै वास्तविक व्यवस्थापन हुँदैन। तपाईंका एकीकरण परीक्षणहरूले पैसा खर्च नगरी वा सर्भरहरू नबनाई API मा भारी मात्रामा अनुरोधहरू पठाउन सक्छन्।
प्रयोगकर्ता सत्रहरू realm सार्वजनिक कुञ्जी विरुद्ध प्रमाणित गरिएका Keycloak-जारी JWT हरू मार्फत प्रमाणीकरण हुन्छन्, र API कुञ्जीले समाधान गरे जस्तै समान Principal वस्तुमा समाधान हुन्छन्। अन्त्यबिन्दुहरू sites.create वा apikeys.manage जस्ता विस्तृत अनुमति कुञ्जीहरूद्वारा नियन्त्रित हुन्छन्, जसलाई प्रत्येक संस्था अनुसार जाँच गरिन्छ — एउटा संस्थाको अनुमतिले छुट्टै, सम्बन्ध नभएको संस्थामा कुनै पहुँच प्रदान गर्दैन, यद्यपि यो यसको मुनि रहेका संस्थाहरूमा लागू हुन्छ।
प्रत्येक टेनेन्ट अनुरोध प्रिन्सिपलबाट सेट गरिएको Postgres संस्था स्कोपसहितको लेनदेनमा चल्छ, त्यसैले पृथकीकरण डेटाबेसद्वारा लागू गरिन्छ, कसैले बिर्सन सक्ने ORM फिल्टरद्वारा होइन। गहिरो सुरक्षाको रूपमा queryset फिल्टर अझै पनि त्यहाँ छ।
README मा API लाई राम्रो देखाउन सजिलो छ, तर वास्तविक ट्राफिकको दबाबमा यसलाई सही तरिकाले सञ्चालन गर्न गाह्रो छ। यी ती भागहरू हुन् जसमा हामीले सबैभन्दा धेरै मिहिनेत गरेका छौं, किनकि यी भागहरूले नै मध्यरातको तीन बजे एकीकरणमा बाधा पुर्याउँछन्।
थोक कार्य कसरी सञ्चालन हुन्छ भन्ने कुरालाई निर्धारण गर्ने हुनाले यहाँ एउटा विवरण औँल्याउनु आवश्यक छ: डुप्लिकेट डोमेनमा आउने 409 ले कुनै पनि भाडामा लिने (tenant) का लागि "के यो होस्टनाम यहाँ होस्ट गरिएको छ?" भन्ने जवाफ दिन्छ, जुन एक इन्युमरेसन ओरेकल (enumeration oracle) र Footprint-Free विरुद्ध वास्तविक डीअनोनिमाइजेसन जोखिम हो। साइट निर्माणलाई थ्रोटल गर्नु एउटा सजिलो समाधान हुने थियो र यसले बल्क-प्रोभिजनिङ उत्पादनलाई पूर्ण रूपमा बिगार्ने थियो। बरु, प्रति प्रिन्सिपल (principal) अस्वीकृत गरिएका डुप्लिकेट-डोमेन प्रयासहरूलाई मात्र बजेटमा सीमित गरिएको छ। सफल सिर्जनाहरू यस विरुद्ध कहिल्यै पनि चार्ज हुँदैनन् — त्यसैले तपाईं दिनभर थोकमा प्रोभिजन गर्न सक्नुहुन्छ, र खोजी गर्ने प्रयासहरू तुरुन्तै रोकिन्छन्।
काम गर्ने तीन फरक तरिकाहरूका लागि, एउटै विशिष्टताका तीन उपभोक्ताहरू।
TypeScript, Python, PHP र Go का लागि सिर्जना गरिएको, विनिर्देशलाई ट्र्याक गर्दछ ताकि हातले लेखिएको र्यापरको प्रतीक्षा नगरी नयाँ अन्तिम बिन्दु तपाईंको भाषामा आइपुग्छ।
एउटा WordPress साइटको ढाँचा तयार गर्नुहोस्, Node बाहेक अरू केही इन्स्टल नगरी यसलाई स्थानीय रूपमा चलाउनुहोस्, र यसलाई डिप्लोय गर्नुहोस्। Zinnector® ले तपाईंले डिप्लोय गर्न लाग्नुभएको स्लटसँग तपाईंको प्रोजेक्टको पूर्व-जाँच गर्छ — PHP संस्करण, डिस्क, फाइल संख्या — र पुश गरेपछि होइन, पुश गर्नुअघि नै चेतावनी दिन्छ। यसले साइन इन गर्ने, साइटहरू सूचीकृत गर्ने, डिप्लोय गर्ने, डोमेन र DNS व्यवस्थापन गर्ने, मेल सेवाहरू पढ्ने, ब्याकअप लिने, अनुमति सूचीमा रहेका WP-CLI चलाउने, लगहरू पछ्याउने र सामूहिक कार्यहरू सञ्चालन गर्ने काम पनि गर्छ। नि:शुल्क, MIT-इजाजतपत्र प्राप्त, र यही सार्वजनिक API मा निर्मित।
साइटहरू, डोमेनहरू, DNS रेकर्डहरू, मेलबक्सहरू र योजनाहरूलाई इन्फ्रास्ट्रक्चर एज कोड (infrastructure as code) को रूपमा व्यवस्थापन गर्नुहोस्। terraform apply ले होस्टिङको व्यवस्था गर्दछ, र तपाईँका वातावरणहरू कसैले नलेखेको क्लिकहरूको शृङ्खलाको सट्टा पुनरुत्पादनयोग्य र समीक्षा गर्न सकिने बन्दछन्।
सिर्जना गरिएका कागजातहरू जुन तपाईंले ब्राउजरबाट पढ्न र कल गर्न सक्नुहुन्छ, जसले सर्भरले कार्यान्वयन गर्ने अन्तिम बिन्दुहरूलाई ठ्याक्कै वर्णन गर्दछ — किनभने दुवै एउटै विनिर्देशबाट आउँछन्।
प्लेटफर्मको पछाडि एक भरपर्दो इभेन्ट स्पाइन छ: प्रत्येक स्थिति परिवर्तनले डाटाबेस परिवर्तनसँगै आणविक रूपमा Postgres मा रहेको ट्रान्ज्याक्सन outbox मा इभेन्ट लेख्छ, र रिले ले यसलाई NATS JetStream मा प्रकाशित गर्दछ। इभेन्टहरू टाइप गरिएका र संस्करण गरिएका हुन्छन् — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending र अन्य।
एउटा अन्तिम बिन्दुलाई WebhookSubscription को रूपमा दर्ता गर्नुहोस् र यसले प्राप्त गर्ने घटना प्रकारहरू छनौट गर्नुहोस्। एउटै स्ट्रिमले सूचनाहरू, विश्लेषणहरू, स्वचालनहरू र तपाईंको एकीकरणलाई समान रूपमा फिड गर्दछ — तपाईंले हामीले प्रयोग गर्ने समान घटनाहरू उपभोग गर्दै हुनुहुन्छ।
प्रत्येक डेलिभरी HMAC-हस्ताक्षरित हुन्छ ताकि तपाईंले यसमा कुनै कारबाही गर्नु अघि यो हाम्रै तर्फबाट आएको हो भनी प्रमाणित गर्न सक्नुहोस्।
असफल भएका डेलिभरीहरूलाई अन्तरालसहित पुनः प्रयास गरिन्छ र प्रत्येक प्रयासलाई WebhookDelivery को रूपमा रेकर्ड गरिन्छ। हामीले के पठायौं भनी सोध्न सहायता टोलीलाई इमेल गर्नुको सट्टा तपाईंले ड्यासबोर्डबाटै डेलिभरीहरू निरीक्षण गर्न र पुनः पठाउन सक्नुहुन्छ।
पाइपलाइन ठ्याक्कै एक पटक हुनुको ढोङ गर्नुको साटो जानाजानी कम्तीमा एक पटक हुने गरी बनाइएको छ। प्रकाशनको बीचमै काम गर्न छोड्ने रिलेको दाबी भाडा अवधि समाप्त हुन्छ र यसका घटनाहरू पुन: प्रकाशित हुन्छन्। खाम आइडी (envelope id) मा नक्कल हटाउनुहोस् र तपाईंको उपभोक्ता संरचनागत रूपमै सही हुन्छ।
एपीआई भनेको विकासकर्ताको कथाको आधा भाग मात्र हो। बाँकी आधा भाग भनेको सार्वजनिक गर्नु हो।
एपीआई एउटा ढोका हो। यी अन्य चार हुन्, र ती प्रत्येकलाई विकासकर्ता स्तरको रूपमा बेच्नुको सट्टा योजनामै समावेश गरिएको छ।
ड्यासबोर्डको साइट पृष्ठबाट खोलिएको ब्राउजरभित्रको VS Code ले इन-बिल्ट git मार्फत त्यस साइटका वास्तविक फाइलहरू सम्पादन गर्दछ र सम्पूर्ण सम्पादक तपाईंको SFTP पहुँच जस्तै एउटै CageFS जेलभित्र हुन्छ। यसले प्रत्यक्ष (LIVE) साइट सम्पादन गर्दछ — बिचमा कुनै स्ट्याजिङ प्रतिलिपि हुँदैन, त्यसैले तपाईंले सुरक्षित गर्नुभएको फाइल लेखिने बित्तिकै सार्वजनिक हुन्छ, यद्यपि स्थिर फाइल CDN क्यासबाट चार घण्टासम्म सेवा दिन जारी रहन सक्छ।
निःशुल्क, MIT-इजाजतपत्र प्राप्त र यही सार्वजनिक API मा निर्मित। WordPress साइटको संरचना तयार गर्नुहोस्, यसलाई आफ्नै मेसिनमा चलाउनुहोस्, तपाईंले डिप्लोय गर्न लाग्नुभएको स्लटसँग यसको पूर्व-जाँच गर्नुहोस् — PHP संस्करण, डिस्क, फाइल सङ्ख्या — र डिप्लोय गर्नुहोस्। Node 24 वा नयाँ संस्करण आवश्यक पर्दछ।
उपकरणहरूको एउटा सूची, ताकि तपाईंले पहिले नै प्रयोग गरिरहनुभएको AI क्लाइन्टले ड्यासबोर्डले प्रयोग गर्ने उही API र उही अनुमतिहरू मार्फत तपाईंका साइटहरूमा काम गर्न सकोस्। तपाईंको आफ्नै क्लाइन्ट जडान हुने उही सर्भर वेब सम्पादकमा जोडिएको हुन्छ। तपाईंले अन्यथा नभनेसम्म पढ्नका लागि मात्र।
ग्राहकको कामको लागि तपाईंको पासवर्ड आवश्यक पर्दैन। इमेल ठेगाना मार्फत कसैलाई आमन्त्रण गर्नुहोस् र उनीहरूले ठ्याक्कै एउटा साइट मात्र पाउनेछन्: उनीहरू दर्शक, सम्पादक वा प्रबन्धकको भूमिकामा आफ्नै रूपमा साइन इन गर्छन्, र कुनै पनि ह्यान्डलर चल्नु अघि अन्य प्रत्येक साइटले 404 प्रतिक्रिया दिन्छ — यो एउटा मात्र जाँच नभई Postgres पङ्क्ति-स्तरको सुरक्षा नीति र अनुरोध-स्तरको बार हो। खाता मालिकले यसलाई एक क्लिकमा प्रदान गर्न र खारेज गर्न सक्नुहुन्छ, जुन उनीहरूको अर्को अनुरोधमा लागू हुन्छ।
हामी प्लेटफर्मलाई होस्ट गरिएको MCP सर्भरको रूपमा प्रस्तुत गर्दछौं: इन्जिन API माथिको एक पातलो प्रोटोकल एडेप्टर जसले समान कार्य क्याटलग, RBAC र अडिट ट्रेलको पुन: प्रयोग गर्दछ। Claude Code, Cursor, ChatGPT, Claude Desktop वा कुनै पनि MCP-सक्षम क्लाइन्टलाई एक पटक जडान गर्नुहोस्, र हामीले API मा थप्ने प्रत्येक क्षमता स्वचालित रूपमा यसको लागि उपलब्ध हुन्छ।
एजेन्टले तीनवटा कुराहरू प्राप्त गर्दछ: Tools (समान API एन्डपोइन्टहरू, विचलित हुन कुनै समानान्तर तर्क छैन), Resources (पढ्न मात्र मिल्ने साइटको स्वास्थ्य, कन्फिग, हालैका लगहरू, मेट्रिक्स, अपटाइम र KB लेखहरू, ताकि यसले कारबाही गर्नु अघि वास्तविक डेटा प्रयोग गरेर निदान गरोस्) र Prompts ("diagnose this site" वा "prepare a migration" जस्ता प्रकाशित कार्यप्रवाह टेम्प्लेटहरू)।
सुरक्षा प्रमाणीकरण जस्तै एउटै सिद्धान्तमा आधारित छ: OAuth 2.1, तपाईंको संस्थासँग बाँधिएका टोकनहरू र पङ्क्ति-स्तरको सुरक्षा लागू गरिएका RBAC अनुमतिहरू, प्रत्येक उपकरणअनुसार दायरा तोक्न सकिने र खारेज गर्न सकिने, उत्पादन वातावरणबाट छुट्ट्याइएको स्यान्डबक्स। विनाशकारी कार्यहरू — मेटाउने, निलम्बन गर्ने, बिलिङ, ठूलो खर्च — का लागि स्पष्ट पुष्टि वा मानव-स्वीकृति नीति आवश्यक पर्दछ। दर सीमा र खर्च सीमाहरूले AI-द्वारा सञ्चालित सशुल्क कार्यहरूलाई सीमित गर्छन्, र प्रत्येक MCP कल पहिचान, उपकरण, तर्क र नतिजासहित अडिट-लग गरिन्छ।
हामी प्रत्येक एपलाई एक-एक गरी एकीकृत गर्नुको सट्टा प्रोटोकललाई समर्थन गर्छौं, जसको अर्थ तपाईंको होस्टिङ एकीकरण परिवर्तन नगरीकन तपाईंको AI उपकरणहरूको छनोट परिवर्तन हुन सक्छ।
हो — यो प्रकाशित र सुदृढ गरिएको उही इन्जिन API हो। ड्यासबोर्ड, एडमिन कन्सोल, CLI, Terraform प्रदायक, MCP सर्भर र वेबहुकहरू सबै एउटै इन्टरफेसका उपभोक्ताहरू हुन्, जसले गर्दा API प्यानलभन्दा पछाडि पर्दैन।
हो। Sandbox कुञ्जीहरू उत्पादन कुञ्जीहरू भन्दा छुट्टै जारी गरिन्छ र परीक्षण मोडमा चल्छन्: कुनै वास्तविक बिलिङ हुँदैन र कुनै वास्तविक प्रोभिजनिङ हुँदैन। आफ्नो CI लाई sandbox प्रमाणहरूमा निर्देशित गर्नुहोस् र पूर्ण अनुरोध तथा प्रतिक्रिया चक्रलाई सुरक्षित रूपमा परीक्षण गर्नुहोस्।
आफ्नो POST मा Idempotency-Key पठाउनुहोस्। रिप्ले रेकर्ड इनलाइनको सट्टा commit मा लेखिन्छ, त्यसैले पुन: प्रयासले वास्तवमा commit नभएको पङ्क्तिको लागि क्यास गरिएको सफलतालाई कहिल्यै रिप्ले गर्न सक्दैन, र असफल हुने अनुरोधले तुरुन्तै आफ्नो लक छोड्छ ताकि तपाईंको सच्याइएको पुन: प्रयास नरोकियोस्। Webhook डेलिभरी डिजाइन अनुसार कम्तिमा एक पटक (at-least-once) हुन्छ — तपाईंको तर्फबाट envelope id मा डीडुप गर्नुहोस्।
आज होइन। API कुञ्जीहरू प्रति संस्था जारी गरिन्छ, त्यसैले धेरै ग्राहक संस्थाहरूमा फैलिएको एकीकरणले प्रत्येकको लागि एउटा कुञ्जी राख्छ। प्रयोगकर्ता प्रिन्सिपलहरूका लागि अनुमतिहरू पनि प्रति संस्था जाँच गरिन्छ: एउटा संस्थामा sites.create हुनुले छुट्टै, असम्बन्धित संस्थामा कुनै पहुँच प्रदान गर्दैन, यद्यपि यो त्यसको मुनि रहेका संस्थाहरूमा लागू हुन्छ। यो जानाजानी गरिएको हो — यसले सम्झौता गरिएको कुञ्जीलाई सम्पूर्ण प्लेटफर्ममा नभई आफ्नै संस्था र त्यस मुनिका उप-संस्थाहरूमा मात्र सीमित गर्दछ।
dev भूमिकाले संस्था पढ्ने, API कुञ्जी व्यवस्थापन, साइटहरू हेर्ने र सिर्जना गर्ने, तिनीहरूलाई पुन: सुरु गर्ने, तिनीहरूको क्यास खाली गर्ने, र टिकटहरू हेर्ने तथा जवाफ दिने कार्यहरू समेट्छ। यसले जानीजानी बिलिङ नियन्त्रणलाई समावेश गर्दैन। ध्यान दिनुहोस् कि डिप्लोय र पुश-टु-लाइभ अनुमतिहरू यसको भाग होइनन् — यदि टोलीको सदस्यलाई ती आवश्यक परेमा, Developer नै सबैभन्दा फराकिलो प्राविधिक भूमिका हो भनी मान्नुको सट्टा, ती अधिकारहरू भएको भूमिका तोक्नुहोस्।
डेलिभरीहरू ब्याकअफका साथ पुन: प्रयास हुन्छन् र प्रत्येक प्रयासलाई तपाईंले निरीक्षण गर्न सक्ने WebhookDelivery को रूपमा रेकर्ड गरिन्छ। अपस्ट्रिममा, घटनाहरूलाई परिवर्तन भएकै समान डाटाबेस लेनदेनमा ट्रान्ज्याक्सनल आउटबक्समा लेखिन्छ, त्यसैले उपभोक्ता उपलब्ध नभएको बेला केही पनि हराउँदैन — बन्द भएको उपभोक्ता ढिलो मात्र हुन्छ, यसले उत्पादकलाई कहिल्यै बिगार्दैन, र तपाईं फर्किएपछि ड्यासबोर्डबाट डेलिभरीहरू पुन: प्ले गर्न सक्नुहुन्छ।
Footprint-Free होस्टिङको कार्डबिनाको १४-दिने परीक्षणबाट सुरु गर्नुहोस् — कुनै भुक्तानी विवरण आवश्यक छैन, ५ वटासम्म साइटहरू। सशुल्क Footprint-Free टियरहरू PBN 5 का लागि $6/महिनाबाट सुरु हुन्छन्। प्रत्येक योजनामा ३०-दिने पैसा फिर्ताको ग्यारेन्टी, निःशुल्क माइग्रेसन र कुनै भेन्डर लक-इन छैन।
स्पेक-फर्स्ट API, उत्पन्न गरिएका SDK हरू, एउटा CLI, एउटा टेराफर्म प्रदायक, हस्ताक्षर गरिएका वेबहुकहरू र एउटा MCP सर्भर — विश्वभरका ७,००,००० भन्दा बढी साइटहरूका लागि हामीले निर्माण गरेको होस्टिङमा। भुक्तानी विवरण बिना, कार्ड-मुक्त १४-दिने परीक्षण सुरु गर्नुहोस्।
निःशुल्क सुरु गर्नुहोस्यीमध्ये प्रत्येक प्लगइनले तपाईंको WordPress साइटलाई MCP सर्भर बनाउँछ, जसले गर्दा Claude, Cursor, VS Code र अन्य एआई सहायकहरूले तपाईंको रूपमा लग इन गरेर र तपाईंलाई गर्न अनुमति भएका कुराहरूमा सीमित रहेर यसमा वास्तविक काम गर्न सक्छन्।