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

කේතය මඟින් ඔබට පාලනය කළ හැකි සත්කාරක සේවාව

Zinn Digital® යනු API-ප්‍රමුඛ කරගත් වේදිකාවකි. අපගේ උපකරණ පුවරුව බලගන්වන එම එන්ජින් API එකම ඔබටද ලැබේ — අනුවාදනය කරන ලද, පිරිවිතර-ප්‍රමුඛ කරගත් සහ නිර්මාණ අවස්ථාවේදීම 100% ලේඛනගත කළ, ඒ මත ජනනය කළ SDK, CLI එකක්, Terraform සපයන්නෙක්, අත්සන් කළ webhooks සහ MCP සේවාදායකයක් ද සහිත වේ. වැඩ කිරීමට ඔබ කුමක් භාවිතා කළද — ටර්මිනලයක්, නල මාර්ගයක්, තත්ත්ව ගොනුවක් හෝ AI නියෝජිතයෙකු වේවා — වේදිකාව ඊට ප්‍රතිචාර දක්වයි.

දායක වූ සවන්දෙන්නන් කිහිප දෙනෙකු වෙත අත්සන් කළ සිදුවීම් ලබා දෙන API අන්ත ලක්ෂ්‍යයක්.
  • 700,000+ලොව පුරා සත්කාරකත්වය සපයන අඩවි
  • 1සෑම මෙවලමක්ම ජනනය කරනු ලබන OpenAPI පිරිවිතරය
  • 4සේවාලාභී SDK — TypeScript, Python, PHP, Go
  • OAuth 2.1සීමා නිර්ණය කළ, අවලංගු කළ හැකි AI නියෝජිත ප්‍රවේශය

තනි API එකක්. සෑම අතුරුමුහුණතක්ම ඒ මත ක්‍රියාත්මක වේ.

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

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

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

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

අන්තර්ක්‍රියාකාරී පරිශීලන ලේඛන, සේවාලාභී SDK හතර, CLI හි බොහෝ කොටස් සහ Terraform සැපයුම්කරුගේ පලංචිය යන සියල්ල එම තනි පිරිවිතරයෙන් ජනනය කෙරේ. එක් මූලාශ්‍රයක්, බොහෝ නිර්මාණ, සැමවිටම සමමුහුර්තව පවතී — ක්‍රියාත්මක කිරීමෙන් බැහැර වූ ලේඛනයක් පසුපස ඔබට කිසි විටෙකත් හඹා යාමට සිදු නොවේ.

අභාවයට යාමේ ප්‍රතිපත්තියක් සමඟ අනුවාදනය කරන ලදි

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

CI හි කොන්ත්‍රාත්තු පරීක්ෂා කර ඇත

සෑම වෙනස්කමකදීම ක්‍රියාත්මක කිරීම සහ පිරිවිතර අතර වන ගිවිසුම් පරීක්ෂණ මෙන්ම OpenAPI ලින්ටින් ධාවනය වේ. කේතය සහ ගිවිසුම අතර ඇති වන වෙනස්කම් හේතුවෙන් බිල්ඩ් එක අසාර්ථක වේ — එබැවින් ඔබ ඔබේ සේවාලාභියා උත්පාදනය කරන පිරිවිතරය සේවාදායකය සැබවින්ම පිළිපදින පිරිවිතරය වේ.

සත්‍යාපනය, විෂය පථය නිර්ණය කිරීම සහ පරිමාණය කිරීමේදී ඇති වන බාධාවන්

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

ආයතනයකට API යතුරු

යතුරු zdk_<mode>_<prefix>_<secret> ආකාරයෙන් දිස්වේ. රහසේ SHA-256 හෑෂ් එකක් පමණක් ගබඩා කර ඇත — නිකුත් කිරීමෙන් පසු අපට ඔබට නැවත යතුරක් පෙන්විය නොහැකි අතර අපගේ දත්ත සමුදායට ප්‍රවේශ වන කිසිවෙකුටද එය කළ නොහැක. යතුරු සතුව විෂය පථයන් ඇත, අවලංගු කළ හැකිය, සහ පුද්ගලයෙකු වෙනුවට සංවිධානයකට නිකුත් කරනු ලැබේ.

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

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

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

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

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

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

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

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

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

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

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

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

සේවාලාභී SDK

TypeScript, Python, PHP සහ Go සඳහා ජනනය කර ඇති අතර, පිරිවිතර හඹා යන බැවින් අතින් ලියන ලද wrapper එකක් සඳහා බලා නොසිට නව අන්ත ලක්ෂ්‍යයක් ඔබගේ භාෂාවට පැමිණේ.

Zinnector®, CLI

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

Terraform සපයන්නා

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

අන්තර්ක්‍රියාකාරී පරිශීලනය

සේවාදායකය මඟින් ක්‍රියාත්මක කරන අන්ත ලක්ෂ්‍යයන් නිවැරදිව විස්තර කරමින්, ඔබට බ්‍රවුසරයෙන් කියවීමට සහ ඇමතීමට හැකි ජනනය කළ ලියකියවිලි — මන්ද දෙකම එකම පිරිවිතරයකින් පැමිණෙන බැවිනි.

ඔබගේ අන්ත ලක්ෂ්‍යය අක්‍රිය වූ විටද ක්‍රියාත්මක වන වෙබ්හුක්

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

ඔබට වැදගත් දේ සඳහා දායක වන්න

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

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

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

ප්‍රමාදයක් සහිතව නැවත උත්සාහ කර ලොග් කරන ලදී

අසාර්ථක වූ බෙදාහැරීම් පසුබැසීමේ කාල පරතරයක් සහිතව නැවත උත්සාහ කරන අතර සෑම උත්සාහයක්ම WebhookDelivery එකක් ලෙස සටහන් වේ. අප එව්වේ කුමක්දැයි විමසමින් සහායක කණ්ඩායමට විද්‍යුත් තැපැල් යවනවා වෙනුවට ඔබට උපකරණ පුවරුවෙන් බෙදාහැරීම් පරීක්ෂා කර නැවත ධාවනය කළ හැකිය.

අවම වශයෙන් එක් වරක්, එබැවින් id මත අනුපිටපත් ඉවත් කරන්න

නල මාර්ගය හිතාමතාම හරියටම එක් වරක් බව මවාපානවාට වඩා අවම වශයෙන් එක් වරක් වන ආකාරයට සකසා ඇත. ප්‍රකාශනය අතරතුර අක්‍රිය වන රිලේ එකක හිමිකම් බද්ද කල් ඉකුත් වන අතර එහි සිදුවීම් නැවත ප්‍රකාශයට පත් කෙරේ. envelope id මත ඩියුප් ඉවත් කරන්න, එවිට ඔබගේ පාරිභෝගිකයා නිර්මාණයෙන්ම නිවැරදි වේ.

කේතය වෙබ් අඩවියට එක් කිරීම

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

  • වින්‍යාස ගොනුවක නොව, අක්තපත්‍ර ගබඩාවේ තබා ඇති යෙදවුම් යතුරු සමඟ, OAuth හරහා GitHub, GitLab හෝ Bitbucket සම්බන්ධ කරන්න.
  • Push මඟින් ශාඛාවෙන්-පරිසරයට සිතියම්ගත කිරීම (main සිට production දක්වා, staging සිට staging දක්වා) සහ composer සහ npm සඳහා ස්ටැක් එකකට අදාළ බිල්ඩ් පියවර සහිත බිල්ඩ්-සහ-යෙදවුම් නල මාර්ගයක් ක්‍රියාත්මක කරයි.
  • යෙදවීමක් අසාර්ථක වූ විට පෙර නිකුතුව වෙත ආපසු යන්න.
  • නරඹන්නන් වෙත ළඟා වීමට පෙර වෙනසක් සැබෑ පරිසරයක තහවුරු කර ගැනීම සඳහා ස්ටේජින් ක්ලෝනකරණය සහ සජීවී කිරීම.
  • CageFS හුදකලා කිරීම යටතේ එක් එක් අඩවිය සඳහා SFTP, එමඟින් සෑම පරිශීලකයෙකුටම පෙනෙන්නේ ඔවුන්ගේම ගොනු පමණි, මෙන්ම හවුල් වේදිකාව මත සිරකළ (jailed) SSH shell එකක්ද ලැබේ.
  • පැනල් ටර්මිනලයෙන් සහ SSH හරහා wp-cli.
  • code-server හරහා බ්‍රවුසරයේ VS Code — වෙබ් අඩවියේ ගොනු සෘජුවම සංස්කරණය කරන, git සහිත සම්පූර්ණ සංස්කාරකයකි.
  • එක් එක් අඩවිය සඳහා PHP අනුවාදය, සංස්කරණය කළ හැකි PHP සැකසුම්, එක් එක් අඩවිය සඳහා දිගු, පරිසර විචල්‍යයන් සහ WP-cron සමඟ සැබෑ cron.

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

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

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

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

Zinnector®, CLI

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

MCP සේවාදායකය

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

එක් එක් අඩවිය සඳහා සංවර්ධක ප්‍රවේශය

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

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

අපි මෙම වේදිකාව සත්කාරක MCP සේවාදායකයක් ලෙස ලබා දෙන්නෙමු: එනම් එකම ක්‍රියා නාමාවලිය, RBAC සහ විගණන මාවත නැවත භාවිත කරන එන්ජින් API මත වූ තුනී ප්‍රොටෝකෝල ඇඩැප්ටරයකි. 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 එක උපකරණ පුවරුව භාවිතා කරන එකම ද?

ඔව් — එය ප්‍රකාශයට පත් කර ශක්තිමත් කරන ලද එන්ජින් API එකම වේ. උපකරණ පුවරුව, පරිපාලක කොන්සෝලය, CLI, Terraform සැපයුම්කරු, MCP සේවාදායකය සහ වෙබ්හුක්ස් යන සියල්ලම එක් මතුපිටක පාරිභෝගිකයින් වේ, එබැවින් API පැනලයට වඩා පසුපසින් නොසිටියි.

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

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

නැවත උත්සාහ කිරීමකින් යම් දෙයක පිටපත් දෙකක් සෑදීම වළක්වා ගන්නේ කෙසේද?

ඔබගේ POST හි Idempotency-Key එකක් එවන්න. නැවත ධාවනය කිරීමේ වාර්තාව inline වෙනුවට commit හිදී ලියවෙන බැවින්, ඇත්ත වශයෙන්ම commit නොවූ පේළියක් සඳහා නැවත උත්සාහ කිරීමකින් කිසි විටෙකත් හැඹිලිගත (cached) සාර්ථකත්වයක් නැවත ධාවනය කළ නොහැක, තවද අසාර්ථක වන ඉල්ලීමක් එහි අගුල වහාම මුදා හරින බැවින් ඔබගේ නිවැරදි කරන ලද නැවත උත්සාහ කිරීම ප්‍රමාද නොවනු ඇත. Webhook බෙදාහැරීම සැලසුමෙන්ම අවම වශයෙන් එක් වරක් (at-least-once) සිදු වේ — ඔබගේ පාර්ශ්වයෙන් envelope id මත අනුපිටපත් ඉවත් කරන්න (dedupe).

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

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

සාදන ලද සංවර්ධක භූමිකාව සැබවින්ම අවසර දෙන්නේ කුමක් සඳහාද?

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

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

බෙදාහැරීම් පසුබැසීමක් (backoff) සමඟ නැවත උත්සාහ කරන අතර සෑම උත්සාහයක්ම ඔබට පරීක්ෂා කළ හැකි WebhookDelivery එකක් ලෙස සටහන් වේ. ඉහළ ධාරාවේ (upstream), සිදුවීම් වෙනස්වීම සිදු වූ දත්ත සමුදා ගනුදෙනුව තුළම ගනුදෙනුමය outbox එකකට ලියනු ලැබේ, එබැවින් පාරිභෝගිකයා (consumer) නොමැති අතරතුර කිසිවක් නැති නොවේ — අක්‍රිය වූ පාරිභෝගිකයෙකු ප්‍රමාද වනවා පමණි, එය කිසි විටෙකත් නිෂ්පාදකයා බිඳ නොදමයි, සහ ඔබ නැවත පැමිණි පසු උපකරණ පුවරුවේ සිට බෙදාහැරීම් නැවත ධාවනය කළ හැකිය.

එය මත පදනම්ව ගොඩනැගීම ආරම්භ කිරීමට වැය වන්නේ කොපමණද?

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

පිරිවිතරය කියවා, ඉන්පසු ඒ අනුව ගොඩනඟන්න

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

නොමිලේ ආරම්භ කරන්න

ඔබේ AI නියෝජිතයාට වැඩ කළ හැකි WordPress ප්ලගින

මෙම සෑම ප්ලගිනකම මඟින් ඔබේ WordPress වෙබ් අඩවිය MCP සේවාදායකයක් බවට පත් කරන බැවින්, Claude, Cursor, VS Code සහ වෙනත් AI සහායකයින්ට ඔබ ලෙස පිවිසී, ඔබට කිරීමට අවසර ඇති දේට සීමා වෙමින් එහි සැබෑ වැඩ කටයුතු කළ හැක.

සංවර්ධකයින් සඳහා වන සියලුම MCP සහ API ලේඛන →