🔌 مستندات REST API

پایه: https://transto.ir/api/v1 — احراز هویت با توکن Sanctum (Authorization: Bearer <TOKEN>) اختیاری است؛ درخواست مهمان هم پذیرفته می‌شود.

ترجمهٔ متن

curl -X POST https://transto.ir/api/v1/translate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "source": "سلام، من پزشک هستم و می‌خواهم به شما کمک کنم.",
    "dialect": "egyptian",
    "engine": "dictionary",
    "segments": true
  }'

پارامترها: source (اجباری، حداکثر ۲۰۰۰ نویسه) · dialect (اجباری: msa, egyptian, levantine, gulf, iraqi, maghrebi) · engine (پیش‌فرض dictionary) · segments (پیش‌فرض false).

نمونهٔ پاسخ

{
  "source": "سلام، من پزشک هستم",
  "target": "أهلاً، أنا دكتور",
  "dialect": { "code": "egyptian", "name_fa": "مصری", "name_ar": "المصري" },
  "provider": "dictionary",
  "stats": {
    "total_segments": 4, "matched": 4, "dialectal": 3,
    "converted": 1, "unknown": 0, "coverage": 100.0, "latency_ms": 12
  },
  "unknown": [],
  "segments": [
    { "source": "سلام", "target": "أهلاً", "pos": "interj", "matched": true, "dialectal": true }
  ],
  "msa": null,
  "dialectized": false,
  "notice": null
}

GET /dialects GET /providers GET /dictionary

ساخت توکن

از صفحهٔ حساب کاربری توکن بسازید؛ توکن فقط یک‌بار نمایش داده می‌شود. سهمیهٔ رایگان: 60 درخواست در دقیقه.

برای دریافت توکن با Sanctum: php artisan sanctum:issue-token --name=my-app --personal-access-tokens