विकासकर्ताहरूका लागि
Zinn Digital® एक API-first प्लेटफर्म हो। हाम्रो ड्यासबोर्ड सञ्चालन गर्ने इन्जिन API नै तपाईँले पाउनुहुनेछ — भर्जन गरिएको, spec-first र निर्माणको समयमा १००% डकुमेन्ट गरिएको, साथै यसमा जेनेरेट गरिएका SDKs, एउटा CLI, एउटा Terraform provider, हस्ताक्षर गरिएका वेबहुकहरू र शीर्षमा एउटा MCP सर्भर रहेका छन्। तपाईँ काम गर्न जुनसुकै कुरा प्रयोग गर्नुहोस् — टर्मिनल, पाइपलाइन, स्टेट फाइल वा एआई एजेन्ट — प्लेटफर्मले ती सबैलाई प्रतिक्रिया दिन्छ।
धेरैजसो होस्टहरूले नियन्त्रण प्यानलमा पछिबाट API जोड्छन्, र त्यो देखिन्छ पनि — प्यानलका आधा सुविधाहरू कहिल्यै बाहिर आउँदैनन्। हामीले यसको विपरीत तरिकाले निर्माण गरेका छौं। ड्यासबोर्ड, एडमिन कन्सोल, CLI, Terraform प्रदायक, MCP सर्भर र तपाईंकै इन्टिग्रेसनहरूले सबै एउटै इन्जिन API प्रयोग गर्छन्। यदि तपाईं यसलाई प्यानलमा गर्न सक्नुहुन्छ भने, तपाईं यसलाई कोडमा पनि गर्न सक्नुहुन्छ।
OpenAPI स्पेक नै सत्यको आधार हो, र स्पेकमा नभई कुनै पनि इन्डपोइन्ट रिलिज हुँदैन। त्यही एउटा नियमले सार्वजनिक API लाई पछिभन्दा पनि निर्माणको समयमै पूर्ण रूपमा कागजात गरिएको बनाउँछ — त्यहाँ कुनै पनि कागजात नगरिएको कुना हुँदैन, किनकि कागजात नगरिएको इन्डपोइन्ट अवस्थित हुन सक्दैन।
अन्तरक्रियात्मक सन्दर्भ कागजातहरू, चारवटा क्लाइन्ट SDKs, CLI को धेरैजसो भाग र Terraform प्रदायक स्क्याफोल्डिङ ती सबै एउटै स्पेकबाट उत्पन्न गरिएका हुन्। एउटै स्रोत, धेरै आर्टिफ्याक्टहरू, सधैँ सिङ्कमा — कार्यान्वयनबाट टाढा गएको कागजातलाई तपाईंले कहिल्यै पछ्याउनु पर्दैन।
इन्डपइन्टहरू /v1 अन्तर्गत एउटा प्रकाशित अप्रचलित नीति र परिवर्तन लगर (changelog) सहित सञ्चालन हुन्छन्। असफल भएको बिल्डबाट पत्ता लगाउनुको सट्टा, कुनै पनि कुरा परिवर्तन हुनुअघि तपाईँलाई लिखित रूपमा जानकारी गराइन्छ।
हरेक परिवर्तनमा कार्यान्वयन-विरुद्ध-विशिष्टता (Implementation-versus-spec) सम्झौता परीक्षणहरू र OpenAPI लिन्टिङ चल्छन्। कोड र सम्झौताबीचको अन्तरले बिल्ड (build) असफल गराउँछ — त्यसैले तपाईंले जुन विशिष्टता (spec) बाट आफ्नो क्लाइन्ट सिर्जना गर्नुहुन्छ, सर्भरले वास्तवमा सोही विशिष्टताको पालना गर्छ।
प्रवेश गर्ने दुई तरिका, ती पछाडि एउटै समान सिद्धान्त। तपाईंले जुनसुकै प्रयोग गरे पनि, उही अनुमति जाँचहरू र उही डेटाबेस-स्तरको पृथकीकरण लागू हुन्छन्।
कीहरू zdk_<mode>_<prefix>_<secret> जस्ता देखिन्छन्। गुप्त कुञ्जी (secret) को SHA-256 ह्याश मात्र भण्डारण गरिन्छ — जारी गरेपछि हामी तपाईंलाई पुन: की देखाउन सक्दैनौं, र हाम्रो डेटाबेसमा पहुँच पुऱ्याउने कसैले पनि सक्दैन। कीहरूमा स्कोपहरू हुन्छन्, रद्द गर्न सकिन्छ, र व्यक्ति अनुसार नभई संस्था अनुसार जारी गरिन्छ।
स्यान्डबक्स कुञ्जीहरू प्रोडक्सन कुञ्जीहरूभन्दा छुट्टै हुन्छन् र स्यान्डबक्स मोडमा चल्छन्: वास्तविक बिलिङ हुँदैन, वास्तविक प्रोभिजनिङ हुँदैन। तपाईंका इन्टिग्रेसन परीक्षणहरूले पैसा खर्च नगरी वा सर्भरहरू निर्माण नगरी API मा भार परीक्षण गर्न सक्छन्।
प्रयोगकर्ता सत्रहरूले Keycloak-जारी गरिएका JWT हरू मार्फत प्रमाणीकरण गर्छन्, जसलाई रियल्म सार्वजनिक कुञ्जी विरुद्ध प्रमाणित गरिन्छ, र API कुञ्जीले झैँ उस्तै Principal अब्जेक्टमा समाधान हुन्छन्। इन्डप्वइन्टहरूले sites.create वा apikeys.manage जस्ता दानेदार अनुमति कुञ्जीहरूमा गेट गर्छन्, जुन प्रत्येक संस्था अनुसार जाँच गरिन्छ — एउटा संस्थामा भएको अनुमतिले छुट्टै, असम्बन्धित संस्थामा कुनै पहुँच प्रदान गर्दैन, यद्यपि यो यसभित्र नेस्ट गरिएका संस्थाहरूमा लागू हुन्छ।
प्रत्येक टेनंटको अनुरोध प्रिन्सिपलबाट सेट गरिएको पोस्टग्रेज अर्ग स्कोपसहितको ट्रान्जेक्सनमा चल्छ, त्यसैले आइसोलेसन ओआरएम फिल्टरबाट होइन, डेटाबेसद्वारा नै लागू गरिन्छ जुन कसैले बिर्सन सक्छ। ग्यारीसेट फिल्टर अझै पनि गहिराइमा सुरक्षाको रूपमा छ।
एउटा API लाई README मा राम्रो देखाउन सजिलो हुन्छ तर वास्तविक ट्राफिकको सामना गर्दा यसलाई सही ढङ्गले चलाउन गाह्रो हुन्छ। यी ती पक्षहरू हुन् जसमा हामीले धेरै मेहनत गरेका छौं, किनकि यिनै कारणले गर्दा राती तीन बजे इन्टिग्रेशनहरू बिग्रने गर्छन्।
उल्लेख गर्न योग्य एउटा विवरण, किनकि यसले बल्क कामको व्यवहारलाई आकार दिन्छ: डुप्लिकेट डोमेनमा हुने ४०९ ले कुनै पनि टेनेन्टको लागि "के यो होस्टनेम यहाँ होस्ट गरिएको छ?" भनी जवाफ दिन्छ, जुन एक इन्युमरेशन ओरेकल हो र Footprint-Free विरुद्धको वास्तविक डीएनिमाइजेसन जोखिम हो। साइट सिर्जनालाई थ्रोटल गर्नु एउटा अल्छी समाधान हुनेथियो र यसले बल्क-प्रोभिजनिङ उत्पादनलाई पूर्ण रूपमा बिगार्ने थियो। यसको सट्टा प्रिन्सिपल प्रति अस्वीकृत डुप्लिकेट-डोमेन प्रयासहरूमा मात्र बजेट लगाइन्छ। सफल सिर्जनाहरूलाई यसबापत कहिल्यै चार्ज गरिँदैन — त्यसैले तपाईं दिनभर बल्क रूपमा प्रोभिजन गर्न सक्नुहुन्छ, र प्रोबिङ लगभग तुरुन्तै समाप्त हुन्छ।
एउटै स्पेसिफिकेसनका तीन उपभोक्ता, काम गर्ने तीन फरक तरिकाका लागि।
TypeScript, Python, PHP र Go का लागि जेनेरेट गरिएको, यसले स्पेसिफिकेसनलाई पछ्याउँछ जसले गर्दा हस्त- लिखित र्यापरको प्रतीक्षा नगरी नयाँ इन्डपोइन्ट तपाईँको भाषामा आइपुग्छ।
WordPress साइटको जग तयार गर्नुहोस्, Node बाहेक अरू केही इन्स्टल नगरी यसलाई स्थानीय रूपमा चलाउनुहोस्, र यसलाई डिप्लोय गर्नुहोस्। Zinnector® ले तपाईंले डिप्लोय गर्न लागेनुभएको स्लटसँग तपाईंको प्रोजेक्टको पूर्व-जाँच गर्दछ — PHP संस्करण, डिस्क, फाइल संख्या — र पछि भन्दा पुश गर्नु अघि नै चेतावनी दिन्छ। यसले साइन इन पनि गर्दछ, साइटहरू सूचीबद्ध गर्दछ, डिप्लोय गर्दछ, डोमेन र DNS व्यवस्थापन गर्दछ, मेल सेवाहरू पढ्दछ, ब्याकअप लिन्छ, अनुमति सूचीमा रहेका WP-CLI चलाउँछ, लगहरू हेर्छ र बल्क अपरेसनहरू सञ्चालन गर्दछ। नि:शुल्क, MIT-लाइसेन्स प्राप्त, र यही सार्वजनिक API मा निर्माण गरिएको।
साइटहरू, डोमेनहरू, DNS रेकर्डहरू, मेलबक्सहरू र योजनाहरूलाई पूर्वाधारको रूपमा कोडको रूपमा व्यवस्थापन गर्नुहोस्। terraform apply ले होस्टिङको व्यवस्था गर्छ, र तपाईंको वातावरणहरू कसैले नटिपेको क्लिकहरूको शृङ्खलाको सट्टा पुनरुत्पादन गर्न सकिने र समीक्षा गर्न योग्य हुन्छन्।
ब्राउजरबाटै पढ्न र कल गर्न सकिने उत्पादन गरिएका कागजातहरू, जसले सर्भरले कार्यान्वयन गर्ने निश्चित एन्डपोइन्टहरूको वर्णन गर्दछ — किनकि दुवै एउटै स्पेसिफिकेसनबाट आउँछन्।
PLATFORM को पछाडि एउटा टिकाउ इभेन्ट स्पाइन छ: प्रत्येक स्टेट परिवर्तनले डाटाबेस परिवर्तनसँगै परमाणु रूपमा (atomically) Postgres मा रहेको ट्रान्जेक्सन आउटबक्समा इभेन्ट लेख्छ, र रिले ले यसलाई NATS JetStream मा प्रकाशित गर्छ। इभेन्टहरू टाइप र भर्जन गरिएका हुन्छन् — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending र बाँकीहरू।
WebhookSubscription को रूपमा एउटा इन्डपइन्ट दर्ता गर्नुहोस् र यसले प्राप्त गर्ने इभेन्ट प्रकारहरू छान्नुहोस्। एउटा स्ट्रिमले सूचनाहरू, एनालिटिक्स, अटोमेसनहरू र तपाईंको इन्टिग्रेशनलाई पनि फिड गर्छ — तपाईं हामीले जस्तै इभेन्टहरू उपभोग गर्दै हुनुहुन्छ।
प्रत्येक डेलिभरी HMAC-हस्ताक्षरयुक्त हुन्छ त्यसैले तपाईंले यसमा काम गर्नुअघि यो हामीबाट आएको हो भनेर प्रमाणित गर्न सक्नुहुन्छ।
विफल भएको डेलिभरीहरू ब्याकअफसँगै पुनः प्रयास गरिन्छन् र प्रत्येक प्रयासलाई WebhookDelivery को रूपमा रेकर्ड गरिन्छ। हामीले के पठाएका थियौँ भनेर सोध्दै समर्थन टोलीलाई इमेल गर्नुको सट्टा तपाईंले ड्यासबोर्डबाट डेलिभरीहरूको निरीक्षण गर्न र पुनः प्ले गर्न सक्नुहुन्छ।
यो पाइपलाइन ठ्याक्कै-एकपटक (exactly-once) भएको नाटक गर्नुको सट्टा जानाजानी कम्तीमा-एकपटक (at-least-once) हुन्छ। प्रकाशन भइरहेको बेला बीचमै मरेको रिलेको दाबी लिज (claim lease) समाप्त हुन्छ र यसका इभेन्टहरू पुन: प्रकाशित हुन्छन्। इभेन्टको खाम आईडीमा डिडुप (Dedupe) गर्नुहोस्, र तपाईंको कन्जुमर (consumer) बनावटअनुसार नै सही हुन्छ।
एउटा API विकासकर्ताको कथाको आधा हिस्सा मात्र हो। अर्को आधा हिस्सा भनेको रिलिज गर्नु हो।
हामी प्लेटफर्मलाई होस्ट गरिएको MCP सर्भरको रूपमा उपलब्ध गराउँछौँ: इन्जिन API माथिको एउटा पातलो प्रोटोकल एडप्टर जसले उही कार्य क्याटलग, RBAC र अडिट ट्रेलको पुनः प्रयोग गर्छ। Claude Code, Cursor, ChatGPT, Claude Desktop वा कुनै पनि MCP-सक्षम क्लाइन्टलाई एकपटक जडान गर्नुहोस्, र हामीले API मा थप्ने प्रत्येक क्षमता स्वतः यसका लागि उपलब्ध हुनेछ।
एजेन्टले तीनवटा कुराहरू पाउँछ: टूलहरू (सator API इन्डपइन्टहरू, कुनै समानान्तर तर्क विचलित नहुने), रिसोर्सहरू (पढ्न मात्र मिल्ने साइटको स्वास्थ्य, कन्फिग, हालका लगरहरू, मेट्रिक्स, अपटाइम र KB लेखहरू, ताकि यसले काम गर्नुअघि वास्तविक डेटा प्रयोग गरेर निदान गरोस्) र प्रम्प्टहरू ("यो साइटको निदान गर्नुहोस्" वा "माइग्रेसनको तयारी गर्नुहोस्" जस्ता प्रकाशित कार्यप्रवाह टेम्प्लेटहरू)।
सुरक्षा प्रमाणीकरणजस्तै नै हो: OAuth 2.1, तपाईंको संस्थामा बाइन्ड गरिएका टोकनहरू र पङ्क्ति-स्तर सुरक्षा (row-level security) लागू गरिएका RBAC अनुमतिहरू, प्रत्येक टूलअनुसार सीमित र खारेज गर्न सकिने, र उत्पादन (production) वातावरणबाट अलग गरिएको स्यान्डबक्स। विनाशकारी कार्यहरू — मेटाउने, निलम्बन गर्ने, बिलिङ, र ठूलो खर्च — का लागि स्पष्ट पुष्टिकरण वा मानव-अनुमोदन नीति आवश्यक पर्छ। दर सीमा (rate limits) र खर्च सीमाहरूले AI द्वारा ट्रिगर गरिएका सशुल्क कार्यहरूलाई नियन्त्रण गर्छन्, र प्रत्येक MCP कलको पहिचान, टूल, तर्कहरू (arguments) र परिणामसहित अडिट-लग राखिन्छ।
हामी प्रत्येक एपलाई एक-एक गरेर जोड्नुको सट्टा प्रोटेकललाई समर्थन गर्छौं, जसको मतलब तपाईंको होस्टिङ इन्टिग्रेसन नबदली नै तपाईंको AI टुलिङको छनौट परिवर्तन हुन सक्छ।
हो — यो एउटै इन्जिन API हो, जुन प्रकाशित र परिष्कृत गरिएको छ। ड्यासबोर्ड, एडमिन कन्सोल, CLI, Terraform प्रदायक, MCP सर्भर र वेबहकहरू सबै एउटै इन्टरफेसका प्रयोगकर्ता हुन्, र यही कारणले API प्यानल भन्दा पछि पर्दैन।
हो। Sandbox का कुञ्जीहरू उत्पादन कुञ्जीहरूभन्दा छुट्टै जारी गरिन्छ र परीक्षण मोडमा चल्छन्: कुनै वास्तविक बिलिङ हुँदैन र कुनै वास्तविक प्रोभिजनिङ हुँदैन। आफ्नो CI लाई sandbox क्रेडिन्सियलहरूमा पोइन्ट गर्नुहोस् र सम्पूर्ण अनुरोध र प्रतिक्रिया चक्र सुरक्षित रूपमा अभ्यास गर्नुहोस्।
तपाईंको POST मा Idempotency-Key पठाउनुहोस्। रिप्ले रेकर्ड इन्लाइनको सट्टा कमिट हुँदा लेखिन्छ, त्यसैले रिट्राइले वास्तवमा कमिट नभएको पङ्क्ति (row) को लागि क्यास गरिएको सफलतालाई कहिल्यै रिप्ले गर्न सक्दैन, र असफल हुने अनुरोधले यसको लक तुरुन्तै रिलीज गर्दछ ताकि तपाईंको सच्याइएको रिट्राइ रोकिने छैन। वेबहुक डेलिभरी डिजाइन अनुसार कम्तीमा एक पटक (at-least-once) हुन्छ — आफ्नो तर्फबाट इन्भेलप आइडी (envelope id) मा डिडुप्लिकेट (dedupe) गर्नुहोस्।
आज होइन। API कुञ्जीहरू संस्थापिच्छे जारी गरिन्छन्, त्यसैले धेरै क्लाइन्ट संस्थामा फैलिएको इन्टिग्रेसनमा प्रत्येकको लागि एउटा कुञ्जी हुन्छ। प्रयोगकर्ता प्रिन्सिपल्सका लागि अनुमतिहरू पनि संस्थापिच्छे जाँच गरिन्छन्: एउटा संस्थामा sites.create राख्दा छुट्टै र सम्बन्धित नभएको अर्को संस्थामा कुनै पहुँच प्रदान गर्दैन, यद्यपि यो त्यसभित्र नेस्ट गरिएका संस्थाहरूमा लागू हुन्छ। यो जानाजानी गरिएको हो — यसले सम्झौता भएको कुञ्जीलाई सम्पूर्ण प्लेटफर्ममा होइन, त्यसको आफ्नै संस्था र त्यस अन्तर्गतका सब-संस्थाहरूमा मात्र सीमित राख्छ।
dev भूमिकामा अर्गनाइजेसन पढ्ने अधिकार, API कुञ्जी व्यवस्थापन, साइटहरू हेर्ने र सिर्जना गर्ने, तिनीहरूलाई पुन: सुरु गर्ने, तिनीहरूको क्यास खाली गर्ने, र टिकटहरू हेर्ने र तिनको जवाफ दिने कार्यहरू पर्छन्। यसले जानाजानी बिलिङ नियन्त्रणलाई बाहिर राख्छ। ध्यान दिनुहोस् कि डिप्लोइ र पुश-टु-लाइभ अनुमतिहरू यसको हिस्सा होइनन् — यदि टोलीका सदस्यलाई ती आवश्यकता छन् भने, डेभलपर सबैभन्दा व्यापक प्राविधिक भूमिका हो भन्ने सोच्नुको सट्टा ती अधिकारहरू बोक्ने भूमिका प्रदान गर्नुहोस्।
डेलिभरीहरू ब्याकअफसँग पुन: प्रयास गरिन्छन् र प्रत्येक प्रयासलाई WebhookDelivery को रूपमा रेकर्ड गरिन्छ जसलाई तपाईँले निरीक्षण गर्न सक्नुहुन्छ। अपस्ट्रिममा, घटनाहरू परिवर्तनको रूपमा एउटै डेटाबेस ट्रान्जेक्सनमा ट्रान्जेक्सन आउटबक्समा लेखिन्छन्, त्यसैले कन्ज्यूमर उपलब्ध नभएको बेला पनि कुनै पनि कुरा हराउँदैन — अफलाइन भएको कन्ज्यूमरले ढिलाइ गराउँछ तर कहिल्यै पनि प्रोड्युसरलाई बिगार्दैन, र तपाईँ पुनः अनलाइन आएपछि ड्यासबोर्डबाट डेलिभरीहरू पुन: प्ले (रिप्ले) गर्न सक्नुहुन्छ।
Footprint-Free Hosting को १४-दिने कार्ड-रहित परीक्षण सुरु गर्नुहोस् — भुक्तानी विवरण आवश्यक छैन, ५ साइटहरूसम्म। सशुल्क Footprint-Free टियरहरू PBN 5 का लागि $6/महिनाबाट सुरु हुन्छन्। प्रत्येक योजनामा ३०-दिने पैसा फिर्ताको ग्यारेन्टी, नि:शुल्क माइग्रेशनहरू र कुनै विक्रेता लक-इन छैन।
निर्दिष्ट पहिलो API (Spec-first API), जेनेरेट गरिएका SDK हरू, एक CLI, एउटा Terraform प्रदायक, हस्ताक्षर गरिएका वेबहूकहरू र एउटा MCP सर्भर — विश्वभर ६,५०,०००+ साइटहरूका लागि हामीले बनाएको होस्टिङमा। भुक्तानी विवरण बिना, कार्डरहित १४-दिए परीक्षणबाट सुरु गर्नुहोस्।
निःशुल्क सुरु गर्नुहोस्