یک فایل را ارسال کنید. تمام زبان‌ها را دریافت کنید.

یک توکن bearer ارسال کنید: Authorization: Bearer $TRANSGLOT_TOKEN. توکن متعلق به یک پروژه است، بنابراین شناسه پروژه در مسیر وجود ندارد و کلید کلی حساب نیز نشت نمی‌کند. شما توکن‌ها را در صفحه پروژه ایجاد می‌کنید و هر کدام قابلیت‌های خاص خود را دارند: push، pull، manage، read، write.

خیر. یک توکن bearer با طرح Starter از ماهی ۱۹ دلار شروع می‌شود. نسخه رایگان کنسول را پوشش می‌دهد که برای بررسی تناسب محصول کافی است، اما نمی‌تواند توکن صادر کند. CLI، اکشن GitHub، وب‌هوک‌ها، MCP و بسته تحویل همگی پشت همان توکن قرار دارند، بنابراین همه با هم ارائه می‌شوند.

POST /v1/push با فایل و فرمت آن، مثلاً -F "file=@lang/en.json" -F "format=laravel_json". پاسخ ۲۰۲ می‌دهد و یک دسته را در صف قرار می‌دهد. فقط ردیف‌هایی که واقعاً تغییر کرده‌اند ترجمه می‌شوند، بنابراین آپلود فایل بدون تغییر هزینه‌ای ندارد.

GET /v1/pull، در هر یک از ۲۰ فرمت، هر زمان که بخواهید. این همان نقطه پایانی است که CLI آن را پوشش می‌دهد و محیط آزمایش API آن را به‌صورت زنده اجرا می‌کند. هیچ درخواست صادراتی برای فایل وجود ندارد و هیچ بازه زمانی نیست که داده‌ها متعلق به شما نباشند.

۶۰ درخواست در دقیقه، که به‌ازای هر توکن محاسبه می‌شود نه به‌ازای هر حساب. اگر از این حد فراتر روید، کد خطای ۴۲۹ با هدر Retry-After دریافت می‌کنید که نشان می‌دهد چند ثانیه باید صبر کنید و هیچ هزینه‌ای اعمال یا داده‌ای ناقص ثبت نمی‌شود. برای CI و محیط تولید توکن‌های جداگانه در نظر بگیرید تا بیلدهای پرهیاهو منابع برنامه شما را مختل نکنند.

There is no fixed list. The validator accepts any BCP-47 tag ICU recognises, which is 708 locales in the table it checks against, plus a structural fallback for tags outside it. Add a locale to the project and the next push includes it.

بیست قالب: JSON مسطح و تودرتو، Laravel PHP و JSON، Android XML، iOS .strings، .stringsdict و .xcstrings، Flutter ARB، XLIFF 1.2 و 2.0، gettext .po، YAML، CSV، XLSX، Java properties، RESX، Markdown، Unity CSV و Unreal PO. هفت مورد از آن‌ها جمع‌ها را حمل می‌کنند و فایل در همان شکلی که ارسال شده بازگردانده می‌شود.

بله. ۱۲ رویداد وب‌هوک وجود دارد، از جمله batch.completed، translation.reviewed، qa.completed و source_drift.repaired. هر تحویل با HMAC و هدر زمان‌مهر امضا می‌شود تا بتوانید آن را تأیید کنید و GET /v1/webhooks/events فهرست کامل را همراه با نمونه بار برای هر کدام برمی‌گرداند.

بله. npx -y @transglot/mcp با استفاده از توکن پروژه شما، ۱۷ ابزار را در دسترس قرار می‌دهد؛ بنابراین دستیار می‌تواند ترجمه‌ای را بخواند، بنویسد، زبانی اضافه کند، اجرای فرآیندی را آغاز کند، دسته‌ای را بررسی یا واژه‌نامه را ویرایش کند. این همان API و همان مجوزهاست که به جای curl، از محیط اجرایی عامل فراخوانی می‌شود.

بله. اکشن گیت‌هاب (transglot/transglot-action@v1) و رابط خط فرمان هر دو این نقاط پایانی را پوشش می‌دهند. هنگامی که ردیفی رد شود، دستور transglot push --wait با کد خروج ۴ متوقف شده و اکشن، آن اجرا را ناموفق اعلام می‌کند. برای جلوگیری از ادغام، آن را روی درخواست‌های کشش (pull requests) اجرا کنید، ورودی commit را روی none تنظیم نمایید، مرحله‌ای اضافه کنید که در صورت نبود کلیدی در فایل دریافت‌شده خطا دهد و کار را به عنوان یک بررسی الزامی در حفاظت شاخه تعریف کنید.

چهار دروازه قطعی هر ردیف را بررسی می‌کنند: نگهدارنده‌ها، جمع‌ها، اصطلاحات واژه‌نامه و طول. یک نگهدارنده خراب، یک فرم جمع ناقص یا یک اصطلاح ممنوعه در واژه‌نامه، یک بار به‌طور خودکار اصلاح مجدد می‌شوند و اگر همچنان ناموفق باشند، ردیف به جای نوشته شدن، رد می‌شود. ردیفی که فقط از نظر طول بیش از حد باشد، نوشته می‌شود و رد نمی‌گردد. GET /v1/batches/:id?include=failures ردیف‌های ردشده و دلیل آن‌ها را فهرست می‌کند.

خیر. /v1 فقط نقاط پایانی و فیلدهای پاسخ جدید اضافه می‌کند؛ فیلدی که هم‌اکنون تجزیه می‌کنید تغییر شکل نمی‌دهد یا حذف نمی‌شود. تغییر مخرب تحت پیشوند نسخه جدید منتشر می‌شود که رزرو شده و هنوز خالی است. گزارش تغییرات API هر انتشار را ثبت می‌کند.