සංවර්ධකයින් සඳහා

කේතයෙන් පාලනය කළ හැකි හෝස්‌ටිං සේවාව

Zinn Digital® යනු API-first වේදිකාවකි. අපගේ උපකරණ පුවරුව (dashboard) ක්‍රියාත්මක කරන එන්ජිමම ඔබටත් ලැබේ — අනුවාදගත කළ, spec-first සහ ඉදිකිරීම් අවස්ථාවේදී 100% ලේඛනගත කළ, ජනනය කරන ලද SDKs, CLI එකක්, Terraform provider එකක්, අත්සන් කරන ලද webhooks සහ ඒ මත ක්‍රියාත්මක වන MCP සේවාදායකයක් (server) සමඟිනි. ඔබ වැඩ කිරීමට භාවිතා කරන ඕනෑම දෙයක් වේවා — ටර්මිනලයක්, පයිප්පලයත් (pipeline), state ගොනුවක් හෝ AI නියෝජිතයෙක් (agent) — වේදිකාව ඒ සඳහා ප්‍රතිචාර දක්වයි.

  • 650,000+ලොව පුරා හොස්ට් කර ඇති අඩවි
  • 1OpenAPI විශේෂාංගය මඟින් සෑම මෙවලමක්ම ජනනය වේ
  • 4ක්ලයින්ට් SDK — TypeScript, Python, PHP, Go
  • OAuth 2.1පරාසගත කළ, ආපසු කැඳවිය හැකි AI-නියෝජිත ප්‍රවේශය

API එකක් පමණයි. සෑම මතුපිටක්ම එය මත ධාවනය වේ.

බොහෝ හෝස්ට් සපයන්නන් පාලන පුවරුවකට පසුව API එකක් අමුණන අතර, එහි ප්‍රතිඵලය පැහැදිලිව පෙනේ - පුවරුවේ විශේෂාංගවලින් අඩක්වත් එළියට එන්නේ නැත. අපි අනෙක් පැත්තට හැඩගස්වා ගොඩනඟා ඇත්තෙමු. ඩෑෂ්බෝඩ් එක, පරිපාලක කොන්සෝලය, CLI එක, Terraform සපයන්නා, MCP සේවාදායකය සහ ඔබේම ඒකාබද්ධ කිරීම් සියල්ලම එකම එන්ජින් API එක භාවිතා කරයි. ඔබට එය පුවරුව තුළ කළ හැකි නම්, ඔබට එය කේතය තුළද කළ හැකිය.

පිරිවිතර-පළමුව, පසුව ලේඛනගත කර නැත

OpenAPI පිරිවිතරය සත්‍යයේ මූලාශ්‍රය වන අතර, පිරිවිතරයේ නොමැති නම් කිසිදු අවසන් ලක්ෂ්‍යයක් (endpoint) නිකුත් නොකෙරේ. එම එකම නීතිය මඟින් මහජන API එක පසුව නොව ඉදිවන අවස්ථාවේදීම සම්පූර්ණයෙන්ම ලේඛනගත කරනු ලබයි — ලේඛනගත නොකළ අවසන් ලක්ෂ්‍යයක් පැවතීමට නොහැකි බැවින්, ලේඛනගත නොකළ කිසිදු කොටසක් නොමැත.

ජනනය කරන ලද, කිසි විටෙකත් අතින් නඩත්තු නොකළේය

අන්තර්ක්‍රියාකාරී විම referência ලේඛන, සේවාදායක SDK හතරම, CLI එකෙන් බොහෝ කොටසක් සහ Terraform සැපයුම්කරු රාමුව ඒ සියල්ල එම තනි පිරිවිතරයෙන් ජනනය වේ. එක් මූලාශ්‍රයක්, කලාකෘති බොහෝමයක්, සැමවිටම සමමුහුර්තව පවතී — ක්‍රියාත්මක කිරීමෙන් බැහැර වූ ලේඛනයක් පසුපස ඔබ කිසි විටෙකත් නොයයි.

අප්‍රමාණකරණ ප්‍රතිපත්තියක් සමඟින් සංස්කරණය කරන ලදී

අන්ත ලක්ෂ්‍යයන් /v1 යටතේ ප්‍රකාශයට පත් කරන ලද අස්ථායිකරණ ප්‍රතිපත්තියක් සහ වෙනස්වීම් ලේඛනයක් සමඟ ක්‍රියාත්මක වේ. අසාර්ථක ගොඩනැඟීමකින් එය සොයා ගන්නවාට වඩා, යමක් වෙනස් වීමට පෙර ඔබට ලිඛිතව දන්වනු ලැබේ.

CI තුළ කොන්ත්‍රාත්-පරීක්ෂා කරන ලදී

සෑම වෙනස්කමකදීම ක්‍රියාත්මක කිරීම සහ පිරිවිතර ගිවිසුම අතර පරීක්ෂණ (Implementation-versus-spec contract tests) සහ OpenAPI linting සිදු කෙරේ. කේතය සහ ගිවිසුම අතර වෙනසක් පැවතුණහොත් එය build එක අසාර්ථක කරයි — එබැවින් ඔබ ඔබේ සේවාදායකයා (client) සෑදීමට භාවිතා කරන පිරිවිතරයමය සේවාදායකය (server) විසින්ද සැබවින්ම පිළිගනු ලබන්නේ.

සත්‍යාපනය, විෂය පථය සහ පරිමාණය කිරීමේදී මතුවන ගැටලු

ඇතුළු වීමට ක්‍රම දෙකකි, නමුත් ඒවාට යටින් පවතින්නේ එකම මූලධර්මයකි. ඔබ කුමන ක්‍රමය භාවිතා කළත්, එකම අවසර පරීක්ෂාවන් සහ එකම දත්ත සමුදා මට්ටමේ හුදකලා කිරීම් අදාළ වේ.

සංවිධානය අනුව API යතුරු

ප.ස්. Keys පෙනුම zdk_<mode>_<prefix>_<secret> ලෙස වේ. රහස්පදයෙහි SHA-256 හැෂ් අගය පමණක් ගබඩා කරනු ලබයි — නිකුත් කිරීමෙන් පසු අපට යතුරක් නැවත පෙන්විය නොහැකි අතර, අපගේ දත්ත සමුදායට ළඟා වන වෙනත් කිසිදු අයෙකුටද එය කළ නොහැක. යතුරු සඳහා විෂය පථයන් (scopes) ඇත, අවලංගු කළ හැක, සහ ඒවා පුද්ගලයෙකුට වඩා සංවිධානයක් පදනම් කර ගනිමින් නිකුත් කරනු ලැබේ.

සජීවී සහ පරීක්ෂණ ක්‍රම, වෙන වෙනම තබා ඇත

සංවර්ධන යතුරු නිෂ්පාදන යතුරු වලින් වෙනස් වන අතර සංවර්ධන මාදිලිය යටතේ ක්‍රියාත්මක වේ: සැබෑ බිල්පත් කිරීමක් හෝ සැබෑ සැපයීමක් සිදු නොවේ. මුදල් වියදම් කිරීමකින් හෝ සේවාදායක සෑදීමකින් තොරව ඔබේ ඒකාබද්ධතා පරීක්ෂණ වලට API වෙත ප්‍රවේශ විය හැක.

මිනිසුන් සඳහා OIDC

පරිශීලක සැසි Keycloak මඟින් නිකුත් කරන ලද JWT සමඟින් සත්‍යාපනය වන අතර, රේල්ම් පොදු යතුරට එරෙහිව සත්‍යාපනය කර, API යතුරක් මඟින් විසඳෙන Principal වස්තුව වෙතම විසඳේ. අවසාන ලක්ෂ්‍යයන් sites.create හෝ apikeys.manage වැනි කැටිති අවසර යතුරු මත පාලනය වන අතර, ඒවා සංවිධානයක් අනුව පරීක්ෂා කරනු ලැබේ - එක් සංවිධානයක ඇති අවසරයක් වෙනත් වෙනම, සම්බන්ධයක් නැති සංවිධානයකට කිසිදු ප්‍රවේශයක් ලබා නොදේ, කෙසේ වෙතත් එය එයට යටින් ඇති සංවිධාන සඳහා අදාළ වේ.

යටින් පවතින පේළි මට්ටමේ ආරක්ෂාව

සෑම කුලී නිවැසියකුගේම ඉල්ලීමක්ම ප්‍රධානියාගෙන් සකස් කරන ලද Postgres ආයතන විෂය පථය සමඟ ගනුදෙනුවක් තුළ ක්‍රියාත්මක වන අතර, එමඟින් හුදකලා කිරීම දත්ත සමුදාය මඟින් බලාත්මක කරනු ලබයි, ORM පෙරනයක් මඟින් නොවේ. ගැඹුරු ආරක්ෂාවක් ලෙස ප්‍රශ්න විමසුම් පෙරනය තවදුරටත් පවතී.

දර්ශන සඳහා පමණක් නොව, යන්ත්‍ර සඳහාම ගොඩනගා ඇත

README එකක API එකක් ලස්සනට පෙන්වීම පහසුය, නමුත් සැබෑ ට්‍රැෆික් එක යටතේ එය ක්‍රියාත්මක කරවීම අපහසුය. උදේ තුනට ඒකාබද්ධ කිරීම් බිඳ වැටීමට හේතු වන්නේ මෙම කොටස් වන බැවින්, අපි මේවා වෙනුවෙන් දැඩි ලෙස වෙහෙස මහන්සි වී ඇත.

තොග වැඩ කටයුතු ක්‍රියාත්මක වන ආකාරය හැඩගස්වන බැවින්, විශේෂයෙන් සඳහන් කළ යුතු වැදගත් කරුණක් නම්: අනුපිටපත් වසම් සඳහා වන 409 ප්‍රතිචාරය මඟින් ඕනෑම කුලීකරුවෙකු (tenant) සඳහා "මෙම host නාමය මෙහි සත්කාරක කර තිබේද?" යන වග බලා ගැනීම සිදු කරයි; එය Footprint-Free වලට එරෙහිව පවතින සැබෑ අනන්‍යතාව හෙළිදරව් වීමේ අවදානමකි. අඩවි නිර්මාණය සීමා කිරීම (throttling) පහසු විසඳුමක් වන්නට ඉඩ තිබූ අතර, එයින් තොග සැපයුම් නිෂ්පාදනය සම්පූර්ණයෙන්ම අක්‍රීය වනු ඇත. ඒ වෙනුවට, ප්‍රතික්ෂේප කරන ලද අනුපිටපත් වසම් උත්සාහයන් පමණක් ප්‍රධානියා අනුව අය වැය කරනු ලැබේ. සාර්ථක නිර්මාණ සඳහා කිසිවිටෙකත් ගාස්තු අය නොකෙරේ — එබැවින් ඔබට මුළු දවසම තොග වශයෙන් සැපයිය හැකි අතර, පරීක්ෂා කිරීම (probing) පාහේ වහාම නතර වේ.

  • සෑම දෝෂයකදීම ස්ථාවර දෝෂ ආවරණයක් පවතී: කේතයක්, මානව පණිවිඩයක්, විකල්ප ක්ෂේත්‍ර මට්ටමේ විස්තර සහ සහාය වෙත සඳහන් කළ හැකි request_id එකක්. වලංගුකරණ දෝෂ මඟින් වැරදි ක්ෂේත්‍ර නම් කරමින් 422 ප්‍රතිචාරය ලබා දේ.
  • POST මත අයිඩෙම්පොටන්සි යතුරු (Idempotency keys), න්‍යාය තුළ (inline) නොමැතිව කමිට් (commit) කිරීමේදී නැවත ධාවන වාර්තාව (replay record) ලියනු ලැබේ — එමඟින් නැවත උත්සාහ කිරීමකදී කමිට් නොවූ පේළියක් නම් කරන ලද හැඹිලිගත (cached) 201 ප්‍රතිචාරයක් කිසිවිටෙක නැවත ධාවනය නොවේ. අසාර්ථක වූ ඉල්ලීමක් මඟින් ක්‍රියාත්මක වෙමින් පවතින (in-flight) අගුල වහාම මුදා හරිනු ලබයි, එබැවින් 422 දෝෂයක් මඟින් ඔබේ නිවැරදි කරන ලද නැවත උත්සාහය අවහිර නොකරයි.
  • UUIDv7 මත යතුරු කට්ටලයක් ලෙස කර්සර පිටුකරණය — එකවර ලියන අවස්ථා යටතේ ස්ථාවර වන අතර, ස්කෑන් කිරීමක් අතරතුර පේළි ඇතුළත් කළ විට පිටු-විස්ථාපනයක් සිදු නොවේ.
  • උත්පාදනය කරන ලද සේවාදායකයෙකුට අනුමාන කිරීම වෙනුවට බුද්ධිමත්ව පසුබැසීමට හැකි වන පරිදි, ප්‍රතිචාර මත RateLimit-Remaining.
  • පරාසයෙන් පිටත ඇති සම්පත් 403 වෙනුවට 404 ලෙස ආපසු ලබා දෙයි — 403 ලබා දීමෙන් සම්පත පවතින බව තහවුරු වේ. එම හේතුව නිසාම ඔබගේ පරාසයෙන් පිටත ඇති සංවිධානයකින් පෙරීම සිදු කළ විට හිස් පිටුවක් ආපසු ලබා දෙයි.
  • අඩවි නිර්මාණය යනු ලියාපදිංචි කිරීමකි, සම්පත් වෙන් කිරීමක් නොවේ: POST /v1/sites මඟින් 201 තත්ත්වය පැකී ඇත (pending) ලෙස ලබා දෙන අතර ගොඩනැඟීමේ ක්‍රියාවලිය කිසි විටෙකත් අවහිර නොකරයි. පේළිය සිදු වන එම ගනුදෙනුව තුළම සිදුවීම ද ක්‍රියාකාරී පිටත පෙට්ටියට (transactional outbox) ලියනු ලැබේ, එබැවින් අඩවියක් පවතින්නේ එහි සම්පත් වෙන් කිරීම ඉල් සිටින බවට සහතික කර ඇත්නම් පමණි.

SDK, CLI එකක් සහ Terraform සපයන්නෙක්

විවිධ වැඩ ක්‍රම තුනක් සඳහා, එකම පිරිවිතර සහිත පාරිභෝගිකයන් තිදෙනෙක්.

ග්‍රාහක SDKs

TypeScript, Python, PHP සහ Go සඳහා ජනනය කර ඇති අතර, අතින් ලියන ලද රැප්පර් එකක් සඳහා බලා නොසිට නව එන්ඩ්පොයින්ට් එකක් ඔබේ භාෂාවට ලැබෙන බව තහවුරු කිරීමට පිරිවිතරය (spec) ලුහුබඳියි.

Zinnector®සm, CLI එක

WordPress අඩවියක් සාදා, Node හැර වෙනත් කිසිවක් ස්ථාපනය කර නොමැතිව එය ප්‍රාදේශීයව ක්‍රියාත්මක කර, එය යොදවන්න. ඔබ යෙදවීමට සූදානම් වන ස්ලොට් එකට එරෙහිව Zinnector® ඔබගේ ව්‍යාපෘතිය පූර්ව-පරීක්ෂා කරයි — PHP අනුවාදය, ඩිස්කය, ගොනු ගණන — සහ තබන පසුබිමට වඩා ඉදිරියෙන් තල්ලු කිරීමට පෙර අනතුරු අඟවයි. එය පුරනය වීම, අඩවි ලැයිස්තුගත කිරීම, යෙදවීම, වසම් සහ DNS කළමනාකරණය කිරීම, තැපැල් සේවා කියවීම, උපස්ථ ලබා ගැනීම, අනුමත කරන ලද WP-CLI ධාවනය කිරීම, ලොග් පරීක්ෂා කිරීම සහ තොග මෙහෙයුම් දියත් කිරීම ද සිදු කරයි. නොමිලේ, MIT බලපත්‍රය යටතේ පවතින අතර, මෙම එකම පොදු API මත ගොඩනගා ඇත.

Terraform සැපයුම්කරු

අඩවි, ඩොමේන්, DNS වාර්තා, තැපැල් පෙට්ටි සහ සැලසුම් කේත ලෙස යටිතල පහසුකම් (infrastructure as code) ලෙස කළමනාකරණය කරන්න. terraform apply මඟින් හෝස්ටිං සැපයෙන අතර, ලිඛිතව සටහන් කර නොමැති ක්ලික් කිරීම් මාලාවක් වෙනුවට ඔබේ පරිසරයන් ප්‍රතිනිෂ්පාදනය කළ හැකි සහ සමාලෝචනය කළ හැකි තත්ත්වයට පත්වේ.

අන්තර්ක්‍රියාකාරී යොමුව

සර්වර් එක ක්‍රියාත්මක කරන එන්ඩ්පොයින්ට්ස් හරියටම විස්තර කරමින්, බ්‍රව්සරයෙන් කියවීමට සහ ඇමතීමට හැකි ජනනය කළ ලේඛන — මන්ද ඒවා දෙකම පැමිණෙන්නේ එකම පිරිවිතරයෙනි.

ඔන්න ඩවුන් වුණත් ක්‍රියාත්මක වන වෙබ්හුක් (Webhooks)

වේදිකාව පිටුපස පවතින්නේ කල් පවතින ඉවෙන්ට් ස්පයින් (event spine) එකකි: සෑම තත්ව වෙනස්වීමක්ම දත්ත සමුදායේ වෙනස්වීම සමඟ පරමාණුකව (atomically) Postgres හි ගනුදෙනු අවුට්බොක්ස් (transactional outbox) වෙත ඉවෙන්ට් එකක් ලියන අතර, රිලේ (relay) එකක් මඟින් එය NATS JetStream වෙත ප්‍රකාශයට පත් කරයි. ඉවෙන්ට් ටයිප් කර සංස්කරණය කර ඇත — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending සහ අනෙක් ඒවා.

ඔබ උනන්දු වන දේ සඳහා දායක වන්න

WebhookSubscription එකක් ලෙස අවසාන ලක්ෂ්‍යයක් (endpoint) ලියාපදිංචි කර එයට ලැබිය යුතු සිදුවීම් වර්ග තෝරා ගන්න. එක් ප්‍රවාහයක් මඟින් දැනුම්දීම්, විශ්ලේෂණ, ස්වයංක්‍රීයකරණයන් සහ ඔබේ ඒකාබද්ධ කිරීම එකවර පෝෂණය කරයි — ඔබ පරිභෝජනය කරන්නේ අප විසින් භාවිතා කරන සිදුවීම්ම වේ.

HMAC මඟින් අත්සන් කර ඇත

සෑම බෙදාහැරීමක්ම HMAC-අත්සන් කර ඇති බැවින්, ක්‍රියාත්මක වීමට පෙර එය අපෙන් පැමිණි බව ඔබට තහවුරු කර ගත හැක.

පසුබැසීම සමඟ නැවත උත්සාහ කරන ලදී, සහ ලොග් කරන ලදී

අසාර්ථක බෙදාහැරීම් බැක්ඕෆ් (backoff) සමඟ නැවත උත්සාහ කරන අතර සෑම උත්සාහයක්ම WebhookDelivery එකක් ලෙස සටහන් වේ. අප එවා ඇත්තේ කුමක්දැයි අසමින් සහාය අංශයට ඊමේල් යවනවා වෙනුවට ඔබට ඩෑෂ්බෝඩ් එකෙන් බෙදාහැරීම් පරීක්ෂා කර නැවත ධාවනය කළ හැක.

ቢያes එකක්වත් එක වතාවක්, එබැවින් id එක මත dedupe කරන්න

මෙම පයිප්පලය හිතාමතාම සැබැවින්ම-එක්වරක් (exactly-once) ලෙස පෙනී සිටිනවාට වඩා අවම වශයෙන්-එක්වරක් (at-least-once) ලෙස සකසා ඇත. ප්‍රකාශනය අතරමැද අක්‍රිය වන රිලේ එකක හිමිකම් බදු කාලය (claim lease) කල් ඉකුත් වන අතර එහි සිදුවීම් නැවත ප්‍රකාශයට පත් කෙරේ. එන්වලෝප් ID (envelope id) එක මත පදනම්ව ඩියුප් ඉවත් කරන්න (dedupe), එවිට ඔබේ පාරිභෝගිකයා නිර්මාණයෙන්ම නිවැරදි වේ.

වෙබ් අඩවියට කේත ඇතුළත් කිරීම

API එකක් කියන්නේ සංවර්ධක කතාවකින් අඩක් පමණි. ඉතිරි අඩ නිකුත් කිරීමයි.

  • OAuth හරහා GitHub, GitLab හෝ Bitbucket සම්බන්ධ කරන්න, සහ 배포 යතුරු (deploy keys) වින්‍යාස ගොනුවක (config file) නොව අක්පත්‍ර ගබඩාවේ (credential store) රඳවා තබා ගන්න.
  • ප්‍රධාන ශාඛාව නිෂ්පාදන පරිසරයටත් (main to production), අතුරු මුහුණත් පරිසරය අතුරු මුහුණත් පරිසරයටත් (staging to staging) ලෙස ශාඛාවෙන් පරිසරයට අනුප්‍රදානය කිරීම සහ composer සහ npm සඳහා එක් එක් ස්ටැක් එකට අදාළ බිල්ඩ් පියවර සහිතව, Push කිරීම මඟින් බිල්ඩ් කර යෙදවීමේ (build-and-deploy) නළ මාර්ගයක් (pipeline) ක්‍රියාත්මක කරයි.
  • යෙදවීම වැරදුණු විට පෙර නිකුතුව වෙත ආපසු යන්න.
  • ප්‍රේක්ෂකයින් වෙත ළඟා වීමට පෙර සැබෑ පරිසරයක වෙනස්කම් පරීක්ෂා කර බැලීම සඳහා, ස්ටේජින් ක්ලෝන් සහ පුෂ්-ටු-ලයිව් (staging clone and push-to-live).
  • CageFS පරිවාරක යටතේ එක් වෙබ් අඩවියක් සඳහා සිර කරන ලද (Jailed) SSH, SFTP සහ FTP, එමගින් සෑම කුලී නිවැසියෙකුම (tenant) දකින්නේ ඔවුන්ගේම ගොනු පමණි.
  • පanel terminal එකෙන් සහ SSH හරහා wp-cli.
  • code-server හරහා බ්‍රව්සරයේ VS Code — ව්‍යාප්ත කිරීම් (extensions), ඒකාබද්ධ ටර්මිනලයක් සහ git සහිත සම්පූර්ණ සංස්කාරකයක් (editor), වෙබ් අඩවියේ ගොනු සෘජුවම සංස්කරණය කරයි.
  • අඩවියෙන් අඩවියට PHP අනුවාදය, සංස්කරණය කළ හැකි PHP සැකසුම්, අඩවියෙන් අඩවියට දිගු, පරිසර විචල්‍යයන් සහ WP-cron සමඟ සැබෑ cron.

අඩවියක වැඩ කිරීමට ක්‍රම හතරක්

API එක එක් දොරටුවකි. මේ අනෙක් හතරයි, ඒවායින් එකක්වත් ඩිවලපර් ටයර් එකක් ලෙස විකුණනු නොලැබේ, සැලැස්මට ඇතුළත් වේ.

වෙබ් සංස්කාරකය

ප්‍රධාන පුවරුවේ ඇති අඩවියේ පිටුවෙන් විවෘත කරන ලද බ්‍රව්සරයේ VS Code, ගිට් (git) ඇතුළත් කර ඇති සහ ඔබේ SFTP ප්‍රවේශය ඇති CageFS කූඩුව තුළම සම්පූර්ණ සංස්කාරකය සමඟින් එම අඩවියේ සැබෑ ගොනු සංස්කරණය කරයි. එය සජීවී (LIVE) අඩවිය සංස්කරණය කරයි — අතරමැද වේදිකාගත කිරීමේ පිටපතක් (staging copy) නොමැත, එබැවින් ඔබ සුරකින ගොනුවක් ලියූ මොහොතේම ප්‍රසිද්ධ වේ.

Zinnector®සm, CLI එක

නොමිලේ, MIT බලපත්‍රය යටතේ පවතින අතර මෙමම පොදු API එක මත ගොඩනගා ඇත. WordPress අඩවියක් සකසන්න, එය ඔබේම යන්ත්‍රයක් මත ධාවනය කරන්න, ඔබ යෙදවීමට සූදානම් වන ස්ලොට් එකට එරෙහිව එය පෙර-පරීක්ෂා කරන්න (PHP අනුවාදය, තැටිය, ගොනු ගණන) සහ යොදවන්න. Node 24 හෝ නව එකක් අවශ්‍ය වේ.

MCP සේවාදායකය

ඔබ දැනටමත් භාවිතා කරන AI සේවාදායකයාට ඩෑෂ්බෝඩ් එක භාවිතා කරන එම API එක සහ එම අවසරයන් හරහා ඔබේ වෙබ් අඩවි මත වැඩ කිරීමට හැකි වන පරිදි මෙවලම් එකම නාමාවලියක ඇත. ඔබේම සේවාදායකයා සම්බන්ධ වන එම සේවාදායකයම වෙබ් සංස්කාරකය තුළට සම්බන්ධ කර ඇත. ඔබ වෙනත් ආකාරයකින් පවසන තුරු කියවීමට පමණක් සීමා වේ.

සංචිත-අඩවි සංවර්ධක ප්‍රවේශය

සේවාදායකයාගේ වැඩ සඳහා ඔබේ මුල්පදය අවශ්‍ය නොවේ. ඊමේල් ලිපිනයක් මඟින් යමෙකුටරා ආරාධනා කරන්න; එවිට ඔවුන්ට ලැබෙන්නේ හරියටම එක් අඩවියක් පමණි: ඔවුන් නරඹන්නෙකු, සංස්කාරකවරයෙකු හෝ කළමනාකරුවෙකු ලෙස තමන් විසින්ම පිවිසෙන අතර, වෙනත් ඕනෑම අඩවියක් ඕනෑම හැසිරවුමක් ක්‍රියාත්මක වීමට පෙර 404 දෝෂයක් ලබා දෙයි — තනි පරීක්ෂාවක් නොව, Postgres පේළි මට්ටමේ ආරක්ෂක ප්‍රතිපත්තියක් සහ ඉල්ලුම් මට්ටමේ වැටකි. ගිණුමේ හිමිකරු එක් ක්ලික් කිරීමකින් එය ලබා දෙන අතර අවලංගු කරයි, එය ඔවුන්ගේ මීළඟ ඉල්ලුමේ සිට බලාත්මක වේ.

ඔබේ AI නියෝජිතයාටද භාවිතා කළ හැකි එකම API එක

අපි මෙම වේදිකාව සංවර්ධනය කළ MCP සේවාදායකයක් (hosted MCP server) ලෙස ලබා දෙන්නෙමු: එනම්, එකම ක්‍රියාකාරකම් නාමාවලිය (action catalogue), RBAC සහ පරීක්ෂණ පථය (audit trail) නැවත භාවිත කරන, එන්ජින් API එක මත ඇති තුනී ප්‍රොටෝකෝල ඇඩැප්ටරයකි (thin protocol adapter). Claude Code, Cursor, ChatGPT, Claude Desktop හෝ ඕනෑම MCP-හැකියාවන් සහිත ක්ලයන්ට් එකක් එක් වරක් සම්බන්ධ කරන්න, එවිට අපි API එකට එකතු කරන සෑම හැකියාවක්ම ස්වයංක්‍රීයවම ඊට ලබා ගත හැකි වේ.

නියෝජිතයාට කරුණු තුනක් ලැබෙයි: මෙවලම් (එකම API සංවේදක, වෙනස් වීමට සමාන්තර තාර්කිකත්වයක් නැත), සම්පත් (පමණක් කියවිය හැකි අඩවි සෞඛ්‍යය, වින්‍යාසය, මෑත කාලීන ලඝු-සටහන්, ප්‍රමිතික, සක්‍රිය කාලය සහ KB ලිපි, එමගින් ක්‍රියා කිරීමට පෙර එය සැබෑ දත්ත මගින් රෝග විනිශ්චය කරයි) සහ විමසුම් ("මෙම අඩවිය රෝග විනිශ්චය කරන්න" හෝ "සංක්‍රමණය සූදානම් කරන්න" වැනි ප්‍රකාශිත වැඩ ප්‍රවාහ සැකිලි).

ආරක්ෂාව පිළිබඳ කතාව ද සහතික කිරීම (authentication) හා සමාන වේ: OAuth 2.1, ඔබේ ආයතනයට (org) බැඳුණු ටෝකන සහ පේළි මට්ටමේ ආරක්ෂාව (row-level security) බලාත්මක කළ RBAC අවසර, මෙවලම අනුව සීමා කළ හැකි සහ අවලංගු කළ හැකි, නිෂ්පාදන පරිසරයෙන් (production) වෙන් කළ සැන්ඩ්බොක්ස්. විනාශකාරී ක්‍රියාමාර්ග — මකා දැමීම, අත්හිටුවීම, බිල්පත් කිරීම, විශාල පිරිවැය — සඳහා පැහැදිලි තහවුරු කිරීමක් හෝ මිනිස් අනුමැතිය පිළිබඳ ප්‍රතිපත්තියක් අවශ්‍ය වේ. වේග සීමාවන් (rate limits) සහ පිරිවැය සීමාවන් (spend caps) මගින් AI මගින් ක්‍රියාත්මක වන ගෙවුම් ක්‍රියාමාර්ග සීමා කරන අතර, සෑම MCP ඇමතුමක්ම අනන්‍යතාව, මෙවලම, තර්ක (arguments) සහ ප්රතිඵලය සමඟ විගණන සටහන් (audit-logged) කරනු ලැබේ.

අපි එක් එක් ඇප් එක වෙන වෙනම ඒකාබද්ධ කරනවාට වඩා ප්‍රොටෝකෝලය සඳහා සහය දක්වමු, එයින් අදහස් වන්නේ ඔබේ හෝස්ටිං ඒකාබද්ධ කිරීම වෙනස් නොකර ඔබට අවශ්‍ය AI මෙවලම් වෙනස් කරගත හැකි බවයි.

නිතර අසන ප්‍රශ්න

ප්‍රසිද්ධ API එක ඩෑෂ්බෝඩ් එක භාවිතා කරන එකම එකද?

ඔව් — එය එකම එන්ජින් API එක වන අතර, එය ප්‍රකාශයට පත් කර සුරක්ෂිත කර ඇත. ඩෑෂ්බෝඩ් එක, කළමනාකරණ කොන්සෝලය, CLI, Terraform සපයන්නා, MCP සේවාදායකය සහ වෙබ් හුක්ස් සියල්ලම එකම පෘෂ්ඨයක පාරිභෝගිකයන් වන අතර, API එක පාලන පුවරුවට වඩා පසුපසින් නොසිටීමට හේතුව එයයි.

මුදල් වියදම් නොකර හෝ සැබෑ සේවාදායක සෑදීමෙන් තොරව මට ඒකාබද්ධ කිරීමක් පරීක්ෂා කළ හැකිද?

ඔව්. සැන්ඩ්බොක්ස් යතුරු නිෂ්පාදන යතුරු වලින් වෙන වෙනම නිකුත් කරනු ලබන අතර පරීක්ෂණ මාදිලියෙන් ක්‍රියාත්මක වේ: සැබෑ බිල්පත් කිරීමක් සහ සැබෑ විධිවිධාන සැපයීමක් නොමැත. ඔබේ CI සැන්ඩ්බොක්ස් අක්තපත්‍ර වෙත යොමු කර ආරක්ෂිතව සම්පූර්ණ ඉල්ලීම් සහ ප්‍රතිචාර චක්‍රය ක්‍රියාත්මක කරන්න.

යමක් දෙවරක් නිර්මාණය වීම නැවත උත්සාහයකින් (retry) වළක්වා ගන්නේ කෙසේද?

ඔබේ POST ඉල්ලීම මත Idempotency-Key එකක් යවන්න. ප්‍රතිචාර ප්‍රතිප්‍රචාරණ වාර්තාව (replay record) අභ්‍යන්තරව නොව කොමිට් (commit) අවස්ථාවේ ලියනු ලබන අතර, එමඟින් ඇත්ත වශයෙන්ම කොමිට් නොවූ පේළියක් සඳහා කැෂි කළ සාර්ථක ප්‍රතිඵලයක් නැවත ධාවනය වීම වැළකේ. තවද, අසාර්ථක වන ඉල්ලීමක් එහි අගුල (lock) වහාම මුදා හරින බැවින්, ඔබ විසින් නිවැරදි කරනු ලබන නැවත උත්සාහය (retry) ප්‍රමාදයකින් තොරව ක්‍රියාත්මක වේ. වෙබ්හුක් (Webhook) බෙදාහැරීම සැලසුම් කර ඇත්තේ අවම වශයෙන් එක් වරක්වත් සිදුවන ආකාරයටය — එබැවින් ඔබගේ පැත්තෙන් එම එන්වෙලොප් හැඳුනුම්පත (envelope id) මඟින් අනුපිටපත් ඉවත් කරගන්න (dedupe).

මගේ සියලුම සේවාදායක සංවිධාන සඳහා එක් API යතුරකට ප්‍රවේශය ලබා දිය හැකිද?

අද නොවේ. API යතුරු ආයතනයක් සඳහා වෙන වෙනම නිකුත් කරනු ලැබේ, එබැවින් සේවාදායක ආයතන කිහිපයක් පුරා පැතිරෙන ඒකාබද්ධ කිරීමක් සඳහා එකක් බැගින් යතුරක් හිමි වේ. පරිශීලක ප්‍රධානීන් සඳහා ආයතන මට්ටමින් අවසර ද පරීක්ෂා කරනු ලැබේ: එක් ආයතනයක sites.create තබා ගැනීමෙන් වෙනත්, සම්බන්ධයක් නැති ආයතනයකට කිසිදු ප්‍රවේශයක් ලබා නොදේ, කෙසේ වෙතත් එය ඊට යටින් ඇති ආයතන සඳහා අදාළ වේ. එය අත්වැරදීමකින් සිදු වූවක් නොවේ — එය සම්පූර්ණ වේදිකාවටම නොව, සම්මුතියකට ලක් වූ යතුරක් එහි තමන්ගේ ආයතනයට සහ ඊට යටින් ඇති උප-ආයතනවලට පමණක් සීමා කරයි.

බිල්ට්-ඉන් Developer කාර්යභාරය මගින් සැබවින්ම ඉඩ දෙන්නේ කුමකටද?

dev භූමිකාවට සංවිධාන කියවීම, API යතුරු කළමනාකරණය, අඩවි බැලීම සහ සෑදීම, ඒවා නැවත ආරම්භ කිරීම, ඒවායේ හැඹිසිය ඉවත් කිරීම සහ ටිකට්පත් බැලීම සහ පිළිතුරු දීම ඇතුළත් වේ. එය බිල්පත් පාලනය හිතාමතාම බැහැර කරයි. යෙදවීම සහ සජීවීව තල්ලු කිරීමේ අවසරයන් එහි කොටසක් නොවන බව සලකන්න — කණ්ඩායම් සාමාජිකයෙකුට ඒවා අවශ්‍ය නම්, Developer යනු පුළුල්ම තාක්ෂණික භූමිකාව යැයි උපකල්පනය කරනවාට වඩා ඒවා රැගෙන යන භූමිකාවක් පවරන්න.

මගේ අන්ත-ලක්ෂ්‍යය (endpoint) පැයක් ක්‍රියා විරහිත වුවහොත් මගේ වෙබ්හුක්ස් වලට සිදු වන්නේ කුමක්ද?

නැවත භාරදීම් පසුබැසීමේ කාල පරාසයන් සහිතව උත්සාහ කරන අතර, සෑම උත්සාහයක්ම ඔබට පරීක්ෂා කළ හැකි WebhookDelivery එකක් ලෙස සටහන් කර ගනු ලැබේ. උඩුගං දෙසින්, වෙනස සිදු වන දත්ත සමුදා ගනුදෙනුව තුළම සිදුවීම් Transactional outbox එකකට ලියවෙන බැවින්, පාරිභෝගිකයෙකු ලබා ගත නොහැකි අතරතුර කිසිවක් අහිමි නොවේ — අක්‍රිය වූ පාරිභෝගිකයෙකු පසුපසින් සිටිනු ඇත, එය කිසි විටෙකත් නිෂ්පාදකයා අක්‍රිය නොකරයි, තවද ඔබ නැවත පැමිණි පසු උපකරණ පුවරුවේ සිට නැවත භාරදීම් ප්‍රතිවාදනය කළ හැක.

එය සමඟ ගොඩනැඟීම ආරම්භ කිරීමට වැය වන්නේ කුමක්ද?

ගෙවීම් විස්තර අවශ්‍ය නොවන සහ අඩවි 5ක් දක්වා වන, Footprint-Free Hosting හි දින 14ක කාඩ්පතක් අවශ්‍ය නොවන අත්හදා බැලීමක් අරඹන්න. ගෙවීම් සහිත Footprint-Free ස්ථර PBN 5 සඳහා මසකට ඩොලර් 6කින් ආරම්භ වේ. සෑම සැලසුමකටම දින 30ක මුදල් ආපසු ගෙවීමේ සහතිකයක්, නොමිලේ සංක්‍රමණ සහ සැපයුම්කරුට සිරවී නොසිටීමේ පහසුකම ඇතුළත් වේ.

විශේෂාංග පිරිවිතර කියවා, ඒ අනුව ගොඩනඟන්න

පිරිවිතර-පළමු API, ජනනය කරන ලද SDK, CLI එකක්, Terraform සපයන්නක්, අත්සන් කරන ලද වෙබ් හුක් සහ MCP සේවාදායකයක් — ලොව පුරා වෙබ් අඩවි 650,000+ ක් සඳහා අප ගොඩනඟන ලද හොස්ටින් මත. කාඩ්පත් අවශ්‍ය නොවන දින 14ක නොමිලේ අත්හදා බැලීමකින් ආරම්භ කරන්න, ගෙවීම් විස්තර අවශ්‍ය නොවේ.

නොමිලේ අරඹන්න