added
ডিপ্লয়-কি মডেল, যেখানে বেয়ারার টোকেনই হলো প্রজেক্ট। এটি CLI এবং GitHub Action উভয়ই চালানোর জন্য ব্যবহৃত হয়।
api v1 · বর্তমান
API চ্যাঞ্জলগ।
কোনো কিছু সরানো হয়নি।
/v1 শুধুমাত্র নতুন জিনিস যোগ করে। নতুন এন্ডপয়েন্ট এবং নতুন রেসপন্স ফিল্ড একই প্রিফিক্সের মধ্যে আসে, এবং আপনি যে ফিল্ডটি ইতিমধ্যে পার্স করছেন তা কখনও পরিবর্তিত হয় না বা অদৃশ্য হয় না। একটি ব্রেকিং চেঞ্জ নতুন ভার্সন প্রিফিক্সের অধীনে প্রকাশিত হবে, যা সংরক্ষিত এবং এখনও খালি।
v1/api/v1
ব্যবহৃত একমাত্র প্রিফিক্স
ব্যবহৃত একমাত্র প্রিফিক্স
5 রিলিজ
11 পরিবর্তন, কোনোটিই ব্রেকিং নয়
লগের গঠন
একটি ভার্সন প্রিফিক্স, কোনো অপসারণ নেই।
Three of these four are properties of this log itself. The fourth is the size of the webhook catalog the API serves.
5
/v1-এ রিলিজ, প্রতিটিই অ্যাডিটিভ
1
ব্যবহৃত ভার্সন প্রিফিক্স। পরবর্তীটি সংরক্ষিত এবং খালি
0
API প্রকাশের পর থেকে ব্রেকিং চেঞ্জ
12
সাইন করা ওয়েবহুক ইভেন্ট। উৎস: App\Enums\WebhookEvent
রিলিজ অনুযায়ী তারিখযুক্ত, সেমভার অনুযায়ী নয়
ভ্রমণ করতে অ্যারো কি ব্যবহার করুন
2026-07-08
CDN ডেলিভারি, ব্যবহার এবং প্লেগ্রাউন্ড
July 8, 2026 · 4টি পরিবর্তন
05 / 05
added
/v1/incontext/translations, /screenshots এবং /suggest ভিজ্যুয়াল এডিটর চালিত করে, যেখানে CORS শুধুমাত্র ওই প্রিফিক্সের জন্য স্কোপড থাকে এবং অন্য কোথাও নয়।
POST /v1/incontext/session একটি পাবলিশেবল কী এবং একটি Origin-এর বিনিময়ে একটি স্কোপড সেশন টোকেন প্রদান করে।
improved
একটি বাইলিঙ্গুয়াল এক্সপোর্ট এখন সাইলেন্টলি সোর্স টেক্সট প্রতিস্থাপন করার পরিবর্তে যা রাউন্ড-ট্রিপ করতে পারেনি তা রিপোর্ট করে। বিদ্যমান ফিল্ডগুলো অপরিবর্তিত থাকে, যা হেডারে রাখার মূল উদ্দেশ্য।
GET /v1/pull-এ X-Skipped-Keys এবং X-Missing-Source-Keys রেসপন্স হেডার যুক্ত করা হয়েছে।
added
পাশাপাশি /v1/glossary/import, /export এবং /extract, যাতে কনসোল না খুলেই টার্ম বেভ ইন এবং আউট করা যায়।
API-তে সম্পূর্ণ টার্ম-বেস CRUD: /v1/glossary-এ GET, POST, PUT এবং DELETE।
added
ফাইন্ডিংগুলো সেই ট্রান্সলেশন রোতে আসে যা আপনি ইতিমধ্যে পুল করেন, তাই নতুন কোনো কিছু পোল করতে হয় না।
POST /v1/qa/run একটি এজেন্টিক কোয়ালিটি পাস ট্রিগার করে এবং রান হ্যান্ডেল ফেরত দেয়।
added
প্রতি এন্ডপয়েন্ট অনুযায়ী সাবস্ক্রাইব করুন। তালিকাটি App\Enums\WebhookEvent-এ রয়েছে, যাতে বর্তমানে বারোটি কেস আছে; এই লাইনের পরিবর্তে enum গণনা করুন।
সাইনড ওয়েবহুকগুলো মূল ব্যাচ পেয়ারের পাশাপাশি কী, ট্রান্সলেশন, ল্যাঙ্গুয়েজ, গ্লোসারি এবং QA ইভেন্ট নির্গত করে।
improved
ডেলিভারিতে পরিবর্তিত প্রতিটি রোর জন্য এক কলের পরিবর্তে একটি কাউন্ট এবং সর্বোচ্চ বিশটি স্যাম্পল থাকে। ডেলিভারি লগগুলো পরবর্তী রিট্রাইয়ের সময় সহ প্রতিটি প্রচেষ্টা রেকর্ড করে।
translation.updated-এর মতো উচ্চ-ফ্রিকোয়েন্সি ইভেন্টগুলো একটি জানালার মধ্যে একটি ডেলিভারিতে একত্রিত হয়, তাই একটি বাল্ক এডিট কখনোই একটি এন্ডপয়েন্টকে প্লাভড করে না।
added
এটি একটি ETag এবং স্বল্পমেয়াদী ক্যাশ ফেরত দেয় এবং If-None-Match-কে 304 দিয়ে সম্মান জানায়। /v{n}-এর অধীনস্থ ইমিউটেবল সিblings কন্টেন্ট অ্যাড্রেসড এবং এক বছরের জন্য ক্যাশড থাকে।
একটি পাবলিক, এজ-ক্যাশেযোগ্য GET /v1/cdn/{project}/{locale} আপনার পাবলিশ করা স্ট্রিং পরিবেশন করে।
added
CI-তে POST /v1/cdn/publish দিয়ে এটি ট্রিগার করুন, এবং X-Transglot-Cdn-Key হেডারে একটি নিবেদিত রিড-অনলি কী দিয়ে রিডগুলো অনুমোদন করুন। আপনার নিজস্ব CDN-এর পেছনে রাখা নিরাপদ।
পাবলিশিং বর্তমান ট্রান্সলেশনগুলোকে ম্যানুয়ালি বা প্রতি পুশে একটি নতুন ইমিউটেবল ভার্সনে উন্নীত করে।
added
কোনো রিকোয়েস্ট বডি সংরক্ষণ করা হয় না। এটি শুধুমাত্র একটি গণনা এবং আর কিছুই নয়।
প্রতিদিন প্রতি টোকেন অনুযায়ী প্রতিটি authenticated /v1 কল গণনা করা হয় এবং ডেপ্লয় হাবে প্রদর্শিত হয়।
improved
প্রোজেক্ট, পুল, ব্যাচ এবং গ্লোসারি এক্সপোর্ট। এটি কাজ করার জন্য কোনো রিকোয়েস্ট বা রেসপন্স শেপ পরিবর্তন করা হয়নি।
ডেপ্লয় হাবে একটি API প্লেগ্রাউন্ড যুক্ত হয়েছে যা আপনার প্রোজেক্টের বিরুদ্ধে লাইভ রিড-অনলি এন্ডপয়েন্ট চালিয়ে দেখায়।
ডিপ্রিকেশন রেজিস্টার
কিছুই নেই বাতিল হয়ে যাচ্ছে।
প্রতিটি প্রকাশিত সারফেসের জন্য একটি করে সারি, যে রিলিজে এটি চালু হয়েছে তা সহ। শেষ কলামটি লক্ষ্য রাখার মতো: কোনো অপসারণ ঘটলে তার অনেক আগেই সেখানে একটি তারিখসহ তা দেখা যাবে।
| সারফেস | চালু হয়েছে | স্থিতি | অপসারণের তারিখ |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | বর্তমান | কোনোটি নির্ধারিত নয় |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | বর্তমান | কোনোটি নির্ধারিত নয় |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | বর্তমান | কোনোটি নির্ধারিত নয় |
POST /v1/qa/run | June 12, 2026 | বর্তমান | কোনোটি নির্ধারিত নয় |
Signed webhook events, twelve typed cases | June 30, 2026 | বর্তমান | কোনোটি নির্ধারিত নয় |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | বর্তমান | কোনোটি নির্ধারিত নয় |
এই টেবিল থেকে কোনো সারি কখনো মুছে ফেলা হয় না। যদি কোনো সারফেস অবসরপ্রাপ্ত হয় তবে তা তার সারি রেখে দেয় এবং একটি তারিখ যুক্ত করে, কারণ পরিকল্পনা করার সুযোগ দেওয়াই এক্ষেত্রে প্রকাশ করার মূল উদ্দেশ্য।
সামঞ্জস্যতার প্রতিশ্রুতি
তিনটি নিয়ম যার ওপর ভিত্তি করে আপনি তৈরি করতে পারেন।
যোগাত্মক
নতুন এন্ডপয়েন্ট এবং নতুন রেসপন্স ফিল্ড /v1-এর মধ্যে চালু হয়। আপনি ইতিমধ্যে যে ফিল্ডটি পার্স করছেন তা পরিবর্তন হয় না এবং অদৃশ্যও হয় না।
নতুন প্রিফিক্স
একটি ব্রেকিং চেঞ্জ এই ভার্সনের মধ্যে না হয়ে একটি নতুন ভার্সন প্রিফিক্সের অধীনে রিলিজ হবে। সেই প্রিফিক্সটি সংরক্ষিত এবং অব্যবহৃত, এবং v1-এর উপরের প্রতিটি রিলিজ সেখানেই ল্যান্ড করেছে।
সৎ হেডার
যখন একটি পুল কিছু রাউন্ড-ট্রিপ করতে পারে না, তখন এটি একটি হেডারে তা উল্লেখ করে। আপনার অজান্তে বডি পরিবর্তন করার পরিবর্তে X-Skipped-Keys এবং X-Missing-Source-Keys যোগ করা হয়েছে।
প্রশ্নোত্তর
API ভার্সনিং এবং ডেপ্রিকেশন সম্পর্কে ডেভেলপারদের প্রশ্ন।
Transglot API ভার্সনযুক্ত কি?
হ্যাঁ, URL প্রিফিক্স দ্বারা। এখন পর্যন্ত প্রকাশিত সবকিছু /v1-এর অধীনে রয়েছে, যা একমাত্র ব্যবহৃত প্রিফিক্স। কোনো ভার্সন হেডার নেই, কোনো তারিখ পিনিং নেই এবং কনফিগার করার মতো কিছু নেই।
কোনো আপডেট কি আমার ইন্টিগ্রেশন ভেঙে দেবে?
/v1-এর মধ্যে নয়। নতুন এন্ডপয়েন্ট এবং নতুন রেসপন্স ফিল্ড যোগ করা হয়, কিন্তু আপনি যে ফিল্ডটি ইতিমধ্যে পার্স করছেন তার গঠন পরিবর্তন হয় না বা এটি অদৃশ্য হয় না। যদি কোনো পরিবর্তন অ্যাডিটিভলি করা না যায়, তবে তা একটি নতুন প্রিফিক্সের অধীনে যায় এবং পুরোনোটি কাজ করতে থাকে।
কিছু ডেপ্রিকেটেড বা অপসারণ করা হয়েছে?
কিছুই নয়, এবং উপরের রেজিস্টারটি সারি অনুসারে তা বলে। প্রকাশিত প্রতিটি সারফেস তার রিলিজ এবং একটি অপসারণ কলাম সহ তালিকাভুক্ত করা হয়েছে, যা বর্তমানে শেষ পর্যন্ত "কোনোটি নির্ধারিত নয়" দেখায়।
অপসারণের জন্য কতটা নোটিশ দেওয়া হবে?
একটি অপসারণ ঘটনার অনেক আগেই একটি তারিখ সহ সেই রেজিস্টারে দেখা যাবে, এবং এরপর সারিটি অদৃশ্য হওয়ার পরিবর্তে টেবিলে থেকে যাবে। পরিকল্পনার জন্য একটি তারিখ পাওয়াই এমনটি প্রকাশ করার মূল উদ্দেশ্য।
কীভাবে জানব যখন কিছু নতুন রিলিজ হয়?
প্রতিটি রিলিজ এই পৃষ্ঠায় তারিখযুক্ত। প্রোডাক্ট চেঞ্জলগ অন্য সব রিলিজ কভার করে, এবং কনসোলে একটি মার্কার দেখায় যখন আপনার পড়া হয়নি এমন কিছু থাকে।
API-এর জন্য আলাদা চেঞ্জলগ কেন?
কারণ API একটি সামঞ্জস্যতার প্রতিশ্রুতি বহন করে, যা প্রোডাক্ট রিলিজের ক্ষেত্রে প্রযোজ্য নয়। একজন ডেভেলপার যখন চেক করেন যে ইন্টিগ্রেশনটি এখনও কাজ করছে কিনা, তখন তাঁকে ফিচার আপডেটগুলোর মধ্যে স্ক্রল না করেই তা জানতে পারা উচিত।
আমি কীভাবে আমার প্ল্যানে API যুক্ত করব?
বেয়ারার টোকেন Starter প্ল্যানে মাসে $19 থেকে শুরু হয়। Free প্ল্যানে শুধুমাত্র কনসোল ব্যবহার করা যায়, কিন্তু টোকেন তৈরি করা যায় না। আর CLI, GitHub Action, ওয়েবহুক এবং MCP—এই সবকিছুই ওই একই টোকনের আড়ালে থাকে।
এন্ডপয়েন্টগুলোর রেফারেন্স কোথায় পাওয়া যাবে?
API পেজে: অথেন্টিকেশন, এন্ডপয়েন্ট, রেট লিমিট, ফাইল ফরম্যাট এবং ওয়েবহুক ক্যাটালগ। এই পেজটি কেবল কী পরিবর্তন হয়েছে এবং কখন হয়েছে তার রেকর্ড।
আপনি যা ইতিমধ্যে চালাচ্ছেন তার সাথে কাজ করে
41 কানেক্টর, ইতিমধ্যে তৈরি।
চুক্তিই হলো প্রোডাক্ট
একটি API-এর ওপর ভিত্তি করে তৈরি করুন যা পরিবর্তিত হয় না।
The API is on Starter and above. Free is $0 with 100,000 words to start (25,000 at sign-up, 75,000 after a phone check), 10,000 a month after, and no API or webhooks.