ডেভলপারদের জন্য
Zinn Digital® হলো একটি API-first প্ল্যাটফর্ম। আমাদের ড্যাশবোর্ড পরিচালনা করার জন্য যে ইঞ্জিন API ব্যবহার করা হয়, আপনিও ঠিক সেটাই পান—ভার্সনযুক্ত, spec-first এবং বিল্ডের সময়ে ১০০% ডকুমেন্টেশন সহ, জেনারেটেড SDK, একটি CLI, একটি Terraform প্রোভাইডার, সাইন করা ওয়েবহুক এবং এর উপরে একটি MCP সার্ভার। আপনি কাজ করার জন্য যা-ই ব্যবহার করুন না কেন—একটি টার্মিনাল, একটি পাইপলাইন, একটি স্টেট ফাইল বা একটি AI agent—প্ল্যাটফর্মটি সেটিতেই সাড়া দেয়।
অধিকাংশ হোস্টিং প্রোভাইডার কন্ট্রোল প্যানেলের সাথে পরে জোড়াতালি দিয়ে একটি এপিআই যুক্ত করে, আর তা বোঝাও যায়—প্যানেলের ফিচারের অর্ধেক অংশ বাইরে আসেই না। আমরা এর উল্টোটা করেছি। ড্যাশবোর্ড, অ্যাডমিন কনসোল, সিএলআই (CLI), টেরাফর্ম প্রোভাইডার, এমসিপি (MCP) সার্ভার এবং আপনার নিজস্ব ইন্টিগ্রেশন—সবকিছুই একই ইঞ্জিন এপিআই ব্যবহার করে। আপনি যদি প্যানেলে তা করতে পারেন, তবে কোডের মাধ্যমেও তা করতে পারবেন।
OpenAPI স্পেসিফিকেশনটিই হলো চূড়ান্ত সত্য, এবং কোনো এন্ডপয়েন্ট স্পেসিফিকেশনে না থাকা পর্যন্ত তা রিলিজ হয় না। এই একটিমাত্র নিয়মের কারণেই পাবলিক এপিআই পরবর্তীতে নয় বরং বিল্ডের সময়ই সম্পূর্ণভাবে নথিবদ্ধ বা ডকুমেন্টেড হয়ে যায়—এখানে কোনো অনথিবদ্ধ কোণ নেই, কারণ কোনো অনথিবদ্ধ এন্ডপয়েন্ট থাকতে পারে না।
ইন্টারেক্টিভ রেফারেন্স ডক, চারটি ক্লায়েন্ট এসডিকে, সিএলআই-এর একটি বড় অংশ এবং টেমপ্লেট হিসেবে ব্যবহৃত টেরাফর্ম প্রোভাইডার—সবকিছুই ওই একটি স্পেসিফিকেশন থেকে তৈরি করা হয়। একটি উৎস, বহু আউটপুট, যা সবসময় সিঙ্ক করা থাকে—বাস্তবায়ন থেকে সরে গেছে এমন কোনো ডকের পেছনে আপনাকে আর কখনো ছুটতে হবে না।
এন্ডপয়েন্টগুলো একটি প্রকাশিত অবমূল্যায়ন নীতি এবং একটি চেঞ্জলগ সহ /v1 এর অধীনে থাকে। কোনো কিছু পরিবর্তনের আগে বিল ব্যর্থ হওয়ার মাধ্যমে তা আবিষ্কার করার চেয়ে আপনাকে লিখিতভাবে জানিয়ে দেওয়া হয়।
প্রতিটি পরিবর্তনে ইমপ্লিমেন্টেশন বনাম স্পেসিফিকেশন কন্ট্রাক্ট টেস্ট এবং ওপেনএপিআই লিন্টিং পরিচালিত হয়। কোড এবং কন্ট্রাক্টের মধ্যে অমিল বিল ফেইল করায়—তাই আপনি যে স্পেসিফিকেশন থেকে আপনার ক্লায়েন্ট জেনারেট করেন, সেটিই সেই স্পেসিফিকেশন যা সার্ভার বাস্তবে মেনে চলে।
প্রasেশনের জন্য দুটি পথ, তবে উভয়ের পেছনে রয়েছে একটিমাত্র অভিন্ন নীতি। আপনি যেটিই ব্যবহার করুন না কেন, একই অনুমতি পরীক্ষা এবং একই ডেটাবেস-স্তরের বিচ্ছিন্নতা প্রযোজ্য হবে।
চাবিগুলোর বিন্যাস হলো zdk_<mode>_<prefix>_<secret>। চাবির শুধুমাত্র একটি SHA-256 হ্যাশ সংরক্ষণ করা হয় — চাবি ইস্যু করার পর আমরা আপনাকে তা আর দেখাতে পারব না এবং আমাদের ডাটাবেজে প্রবেশকারী কেউও তা দেখতে পারবে না। চাবিগুলোতে স্কোপ থাকে, এগুলো বাতিল করা যায় এবং প্রতিটি ব্যক্তির পরিবর্তে প্রতিষ্ঠানের ভিত্তিতে ইস্যু করা হয়।
স্যান্ডবক্স কিগুলি প্রোডাকশন কিগুলি থেকে আলাদা এবং স্যান্ডবক্স মোডে কাজ করে: কোনো আসল বিলিং নেই, কোনো আসল প্রভিশনিং নেই। আপনার ইন্টিগ্রেশন টেস্টগুলি টাকা খরচ না করে বা সার্ভার তৈরি না করে এপিআই (API)-কে বারবার কল করতে পারে।
ব্যবহারকারী সেশনগুলো Keycloak-প্রদত্ত JWT দিয়ে প্রমাণীকরণ করে, যা রিয়েলম পাবলিক কি-এর বিপরীতে যাচাই করা হয় এবং একটি API কী যে প্রিন্সিপাল অবজেক্টে রূপান্তর হয়, ঠিক সেটিতেই রূপান্তরিত হয়। এন্ডপয়েন্টগুলো sites.create বা apikeys.manage-এর মতো সুনির্দিষ্ট অনুমতি কি-এর ওপর ভিত্তি করে প্রবেশাধিকার নিয়ন্ত্রণ করে, যা প্রতিটি প্রতিষ্ঠানের জন্য আলাদাভাবে যাচাই করা হয়—একটি প্রতিষ্ঠানে থাকা অনুমতি সম্পূর্ণ পৃথক ও সম্পর্কহীন অন্য কোনো প্রতিষ্ঠানে কোনো প্রবেশাধিকার দেয় না, যদিও এটি এর অধীনে নেস্টেড থাকা প্রতিষ্ঠানগুলোর ক্ষেত্রে প্রযোজ্য।
প্রতিটি টেন্যান্ট অনুরোধ একটি ট্রানজেকশনে চালিত হয় যেখানে প্রিন্সিপাল থেকে পোস্টগ্র্রেস অর্গ স্কোপ সেট করা থাকে, তাই আইসোলেশন ডাটাবেস দ্বারা প্রয়োগ করা হয়, কোনো ওআরএম ফিল্টার দ্বারা নয় যা কেউ ভুলে যেতে পারে। কোয়েরিসেট ফিল্টারটি গভীর সুরক্ষার অংশ হিসেবে এখনও সেখানে রয়েছে।
একটি API-কে README-তে দেখতে ভালো করা সহজ এবং আসল ট্রাফিকের নিচে এটিকে টিকিয়ে রাখা কঠিন। এই সেই অংশগুলো যা নিয়ে আমরা অনেক পরিশ্রম করেছি, কারণ এগুলোই সেই অংশ যা রাত তিনটার সময় ইন্টিগ্রেশন ভেঙে দেয়।
উললেখ করার মতো একটি খুঁটিনাটি বিষয়, যা বাল্ক কাজের আচরণ নির্ধারণ করে: একটি ডুপ্লিকেট ডোমেনে ৪০৯ রেসপন্স যেকোনো টেন্যান্টের জন্য "এই হোস্টনাম কি এখানে হোস্ট করা আছে?" এই প্রশ্নের উত্তর দেয়, যা একটি এনিউমারেশন ওরাকল এবং Footprint-Free-এর বিরুদ্ধে একটি বাস্তব ড্যানোনিমিজেশন ঝুঁকি। সাইট তৈরি সীমিত করা একটি সহজ সমাধান হতে পারত এবং এতে বাল্ক-প্রভিশনিং পণ্যটি পুরোপুরি ভেঙে যেত। এর পরিবর্তে, শুধুমাত্র প্রত্যাখ্যাত ডুপ্লিকেট-ডোমেন প্রচেষ্টাগুলোর ওপর প্রিন্সিপাল অনুযায়ী বাজেট নির্ধারণ করা হয়। সফলভাবে তৈরি হওয়া সাইটগুলো থেকে কখনো চার্জ কাটা হয় না—তাই আপনি সারা দিন বাল্ক প্রোভিশন করতে পারবেন এবং প্রোবিং প্রায় সঙ্গে সঙ্গেই বন্ধ হয়ে যায়।
তিনটি ভিন্ন কাজের পদ্ধতির জন্য একই স্পেসিফিকেশনের তিনজন গ্রাহক।
TypeScript, Python, PHP এবং Go-এর জন্য জেনারেট করা, স্পেক ট্র্যাক করে যাতে একটি নতুন এন্ডপয়েন্ট হাত দিয়ে লেখা র্যাপারের জন্য অপেক্ষা না করেই আপনার ভাষায় পৌঁছে যায়।
একটি WordPress সাইট তৈরি করুন, নোড (Node) ছাড়া অন্য কিছু ইনস্টল না করেই স্থানীয়ভাবে এটি চালান এবং এটি ডিপ্লয় করুন। Zinnector® আপনার প্রজেক্টটিকে আপনি যে স্লটে ডিপ্লয় করতে চলেছেন তার সাপেক্ষে প্রি-ফ্লাইট করে — পিএইচপি (PHP) সংস্করণ, ডিস্ক, ফাইলের সংখ্যা — এবং পুশ করার পরে নয় বরং আগেই সতর্ক করে। এটি সাইন ইন করে, সাইটগুলোর তালিকা দেখায়, ডিপ্লয় করে, ডোমেইন ও ডিএনএস (DNS) পরিচালনা করে, মেল পরিষেবাগুলো পড়ে, ব্যাকআপ নেয়, হোয়াইট-লিস্টেড WP-CLI চালায়, লগ টেইল করে এবং বাল্ক অপারেশন চালায়। ফ্রি, MIT-লাইসেন্সপ্রাপ্ত এবং এই একই পাবলিক API-এর উপর নির্মিত।
ইনফ্রাস্ট্রাকচার অ্যাজ কোড হিসেবে সাইট, ডোমেইন, ডিএনএস রেকর্ড, মেইলবক্স এবং প্ল্যানগুলো পরিচালনা করুন। terraform apply হোস্টিং প্রভিশন করে, এবং আপনার এনভায়রনমেন্টগুলো কারোর লিখে না রাখা কিছু ক্লিকের সিকোয়েন্সের পরিবর্তে পুনরুৎপাদনযোগ্য ও পর্যালোচনাযোগ্য হয়ে ওঠে।
জেনারেটেড ডক্স যা আপনি ব্রাউজার থেকে পড়তে এবং কল করতে পারবেন, যা সার্ভার যে এন্ডপয়েন্টগুলি বাস্তবায়ন করে সেগুলির নিখুঁত বর্ণনা দেয় — কারণ উভয়ই একই স্পেস থেকে এসেছে।
প্ল্যাটফর্মটির পেছনে রয়েছে একটি টেকসই ইভেন্ট স্পাইন: প্রতিটি স্টেট পরিবর্তন ডেটাবেজ পরিবর্তনের সাথে অ্যাটমিকভাবে Postgres-এর একটি ট্রানজ্যাকশনাল আউটবক্সে একটি ইভেন্ট লেখে, এবং একটি রিলে তা NATS JetStream-এ প্রকাশ করে। ইভেন্টগুলি টাইপ করা এবং ভার্সন করা — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending এবং বাকিগুলি।
একটি এন্ডপয়েন্টকে WebhookSubscription হিসেবে রেজিস্ট্রার করুন এবং এটি কোন ধরনের ইভেন্ট গ্রহণ করবে তা বেছে নিন। একটি মাত্র স্ট্রিম নোটিফিকেশন, অ্যানালিটিক্স, অটোমেশন এবং আপনার ইন্টিগ্রেশন—সবকিছুকেই ফিড করে; আপনি ঠিক সেই ইভেন্টগুলোই ব্যবহার করছেন যা আমরা করি।
প্রতিটি ডেলিভারি HMAC-স্বাক্ষরিত, তাই আপনি পদক্ষেপ নেওয়ার আগে এটি আমাদের কাছ থেকে এসেছে কি না তা যাচাই করতে পারেন।
ব্যর্থ ডেলিভারিগুলি ব্যাকঅফ সহ পুনরায় চেষ্টা করা হয় এবং প্রতিটি প্রচেষ্টা একটি WebhookDelivery হিসাবে রেকর্ড করা হয়। আমরা কী পাঠিয়েছি তা জানতে সহায়তা কেন্দ্রে ইমেল করার পরিবর্তে আপনি ড্যাশবোর্ড থেকে ডেলিভারিগুলি পরীক্ষা করে দেখতে এবং পুনরায় চালাতে পারেন।
পাইপলাইনটি নিখুঁতভাবে-একবার হওয়ার ভান করার চেয়ে জেনেশুনেই অন্তত-একবার-এর নীতি অনুসরণ করে। মাঝপথে বন্ধ হয়ে যাওয়া কোনো রিলে-এর দাবি লিজের মেয়াদ শেষ হয় এবং এর ইভেন্টগুলো পুনরায় প্রকাশিত হয়। এনভেলপ আইডি-র ওপর ডিডুপ করুন এবং আপনার কনজিউমার ডিজাইন অনুসারেই সঠিক থাকবে।
একটি এপিআই ডেভেলপারদের গল্পের কেবল অর্ধেক। বাকি অর্ধেক হলো শিপিং।
আমরা প্ল্যাটফর্মটিকে একটি হোস্ট করা MCP সার্ভার হিসেবে উন্মুক্ত করি: ইঞ্জিন API-র ওপরে একটি পাতলা প্রোটোকল অ্যাডাপ্টার যা অভিন্ন অ্যাকশন ক্যাটালগ, RBAC এবং অডিট ট্রেল পুনরায় ব্যবহার করে। Claude Code, Cursor, ChatGPT, Claude Desktop বা যেকোনো MCP-সক্ষম ক্লায়েন্ট একবার সংযুক্ত করুন, এবং আমরা API-তে যে প্রতিটি ক্ষমতা যোগ করব তা স্বয়ংক্রিয়ভাবে সেটির জন্য উপলব্ধ হয়ে যাবে।
এজেন্ট তিনটি জিনিস পায়: টুলস (একই এপিআই এন্ডপয়েন্ট, ভিন্নভাবে পরিবর্তনের জন্য কোনো সমান্তরাল লজিক নেই), রিসোর্সেস (রিড-অনলাই সাইট হেলথ, কনফিগারেশন, সাম্প্রতিক লগ, মেট্রিকস, আপটাইম এবং কেবি আর্টিকেলস, যাতে এটি পদক্ষেপ নেওয়ার আগে বাস্তব ডেটা দিয়ে রোগ নির্ণয় করতে পারে) এবং প্রম্পটস (প্রকাশিত ওয়ার্কফ্লো টেমপ্লেট যেমন "diagnose this site" বা "prepare a migration")।
নিরাপত্তার বিষয়টিও ঠিক প্রমাণীকরণের মতোই: OAuth 2.1, আপনার সংস্থার সাথে আবদ্ধ টোকেন এবং রো-লেভেল সিকিউরিটি প্রয়োগকৃত RBAC অনুমতি, যা প্রতিটি টুলের জন্য নির্দিষ্ট ও বাতিলযোগ্য এবং স্যান্ডবক্স প্রোডাকশন থেকে আলাদা। ধ্বংসাত্মক কাজগুলোর—ডিলিট, সাসপেন্ড, বিলিং, বড় অংকের খরচ—জন্য স্পষ্ট নিশ্চিতকরণ বা মানব-অনুমোদনের নীতি প্রয়োজন। রেট লিমিট এবং খরচের সীমা এআই-চালিত পেইড অ্যাকশনগুলোকে নিয়ন্ত্রণ করে, এবং প্রতিটি MCP কল পরিচয়, টুল, আর্গুমেন্ট এবং ফলাফলসহ অডিট-লগ করা হয়।
আমরা প্রতিটি অ্যাপ আলাদাভাবে ইন্টিগ্রেট করার পরিবর্তে প্রোটোকলটিকে সমর্থন করি, যার অর্থ আপনার হোস্টিং ইন্টিগ্রেশন পরিবর্তন না করেই আপনার পছন্দের এআই টুলিং পরিবর্তন করতে পারবেন।
হ্যাঁ — এটি একই ইঞ্জিন এপিআই, যা প্রকাশিত এবং পরীক্ষিত। ড্যাশবোর্ড, অ্যাডমিন কনসোল, সিএলআই, টেরাফর্ম প্রোভাইডার, এমসিপি সার্ভার এবং ওয়েবহুক—সবাই একই ইন্টারফেস ব্যবহার করে, আর সেই কারণেই এপিআই প্যানেলের তুলনায় পিছিয়ে থাকে না।
হ্যাঁ। স্যান্ডবক্স কি (keys) প্রডাকশন কি থেকে আলাদাভাবে ইস্যু করা হয় এবং এটি টেস্ট মোডে চলে: কোনো আসল বিলিং বা আসল প্রভিশনিং হয় না। আপনার CI-কে স্যান্ডবক্স ক্রেডেন্সিয়ালের দিকে নির্দেশ করুন এবং নিরাপদে সম্পূর্ণ রিকোয়েস্ট ও রেসপন্স সাইকেল যাচাই করুন।
আপনার POST এ একটি Idempotency-Key পাঠান। রিপ্লে রেকর্ডটি ইনলাইনের পরিবর্তে কমিটের সময় লেখা হয়, তাই কোনো রিট্রি কখনোই এমন একটি সারির জন্য ক্যাশ করা সফল ফলাফল রিপ্লে করতে পারে না যা আসলে কমিট হয়নি, এবং একটি ব্যর্থ অনুরোধ অবিলম্বে এর লক মুক্ত করে দেয় যাতে আপনার সংশোধিত রিট্রি আটকে না যায়। ওয়েবহুক ডেলিভারি ডিজাইন অনুযায়ী অন্তত একবার (at-least-once) নিশ্চিত করা হয় — আপনার প্রান্তে এনভলাপ আইডিতে ডিডুপ (dedupe) করুন।
আজ নয়। এপিআই কীগুলো প্রতিটি প্রতিষ্ঠানের জন্য আলাদাভাবে ইস্যু করা হয়, তাই একাধিক ক্লায়েন্ট সংস্থাকে কভার করে এমন একটি ইন্টিগ্রেশনের জন্য প্রতিটির আলাদা একটি করে কী প্রয়োজন। ব্যবহারকারী প্রিন্সিপালদের ক্ষেত্রেও প্রতিটি প্রতিষ্ঠানের জন্য অনুমতি আলাদাভাবে যাচাই করা হয়: একটি সংস্থায় sites.create থাকার অর্থ এই নয় যে অন্য কোনো স্বতন্ত্র সংস্থায় অ্যাক্সেস পাওয়া যাবে, যদিও এটি তার অধীনে থাকা নেস্টেড সংস্থাগুলোর ক্ষেত্রে প্রযোজ্য। এটি সুপরিকল্পিতভাবে করা হয়েছে—যাতে একটি আপস করা বা ক্ষতিগ্রস্ত কী পুরো প্ল্যাটফর্মের পরিবর্তে কেবল তার নিজস্ব সংস্থা এবং তার অধীনস্থ উপ-সংস্থাগুলোর মধ্যেই সীমাবদ্ধ থাকে।
ডেভ রোলের মধ্যে রয়েছে অর্গানাইজেশন রিড, এপিআই কি ম্যানেজমেন্ট, সাইট দেখা এবং তৈরি করা, সেগুলোকে রিস্টার্ট করা, ক্যাশ মুছে ফেলা এবং টিকিট দেখা ও সেগুলোর জবাব দেওয়া। এতে সুনির্দিষ্টভাবে বিলিং নিয়ন্ত্রণ বাদ দেওয়া হয়েছে। মনে রাখবেন যে ডিপ্লয় এবং পুশ-টু-লাইভ অনুমতিগুলো এর অংশ নয়—যদি কোনো টিম সদস্যের সেগুলোর প্রয়োজন হয়, তবে ডেভেলপারকে সবচেয়ে বিস্তৃত প্রযুক্তিগত রোল মনে না করে বরং এই অনুমতিগুলো বহন করে এমন একটি রোল অ্যাসাইন করুন।
পুনরায় চেষ্টার মধ্যবর্তী সময় বিরতি বাড়িয়ে ডেলিভারিগুলো আবার চেষ্টা করা হয় এবং প্রতিটি চেষ্টা একটি WebhookDelivery হিসেবে রেকর্ড করা হয় যা আপনি পর্যবেক্ষণ করতে পারেন। আপস্ট্রিমে, পরিবর্তনটির সাথেই একই ডাটাবেস ট্রানজ্যাকশনে ইভেন্টগুলো একটি ট্রানজ্যাকশনাল আউটবক্সে লেখা হয়, তাই কনজিউমার অনুপলব্ধ থাকলেও কোনো কিছু হারিয়ে যায় না — কনজিউমার ডাউন থাকলে তা কেবল পিছিয়ে পড়ে, প্রডিউসারকে কখনো ব্যাহত করে না এবং আপনি পুনরায় সক্রিয় হওয়ার পর ড্যাশবোর্ড থেকে ডেলিভারিগুলো আবার চালিয়ে দেখতে পারেন।
Footprint-Free Hosting-এর একটি কার্ড-মুক্ত ১৪ দিনের ট্রায়াল শুরু করুন — কোনো পেমেন্ট বিশদ বিবরণ ছাড়াই, ৫টি পর্যন্ত সাইটের জন্য। পেইড Footprint-Free স্তরগুলি PBN 5-এর জন্য $6/মাস থেকে শুরু হয়। প্রতিটি প্ল্যানে ৩০ দিনের মানি-ব্যাক গ্যারান্টি, বিনামূল্যে মাইগ্রেশন এবং কোনো ভেন্ডর লক-ইন নেই।
স্পেক-প্রথম এপিআই, জেনারেট করা এসডিকে, একটি সিএলআই, একটি টেরাফর্ম প্রোভাইডার, সাইন করা ওয়েবহুক এবং একটি এমসিপি সার্ভার — বিশ্বজুড়ে ৬,৫০,০০০+ সাইটের জন্য আমরা যে হোস্টিং তৈরি করেছি তাতে। কোনো পেমেন্টের বিবরণ ছাড়াই, কার্ড ছাড়া ১৪ দিনের ট্রায়াল দিয়ে শুরু করুন।
বিনামূল্যে শুরু করুন