ترجمه گوگل - مترجم

با استفاده از این وب‌سرویس می‌توانید انواع متون کوتاه، بلند و مقاله‌ها را بدون محدودیت به تمامی ۲۴۹ زبان زنده و محلی دنیا ترجمه کنید. این سرویس مجهز به تشخیص خودکار زبان، ارائه تلفظ صوتی/فینگیلیش، لغت‌نامه و معانی کلمات، و اعتبارسنجی دقیق کدهای زبان می‌باشد.

مشخصات

مشخصه	مقدار
دسته‌بندی	ابزار
وضعیت	فعال
نسخه API	apis-1
فرمت پاسخ	JSON
آدرس پایه	https://open.nestapi.ir
مسیر	/apis-1/google-translate
لینک کامل	https://open.nestapi.ir/apis-1/google-translate

متدهای HTTP

متد	مسیر	نوع ورودی
GET	/apis-1/google-translate	Query String

پارامترها

پارامترهای Query String

نام	نوع	الزامی	پیش‌فرض	توضیحات
text	string	بله	—	متن مورد نظر برای ترجمه
to	string	خیر	انتخاب هوشمند	کد زبان مقصد، مانند en، ar، tr، de، fr، bal یا ckb
from	string	خیر	auto	کد زبان مبدأ؛ auto برای تشخیص خودکار
action	string	خیر	—	مقدار languages برای دریافت فهرست کامل ۲۴۹ زبان

نمونه درخواست

لینک مستقیم

GET https://open.nestapi.ir/apis-1/google-translate?text=Hello

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/google-translate?text=Hello"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->googleTranslate(text: 'Hello');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.google_translate(text="Hello")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.googleTranslate({ text: "Hello" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

کدهای خطا

کد	وضعیت	علت
NOT_FOUND	404	مسیر وجود ندارد، یا متد روی آن ثبت نشده
PARAM_NOT_FOUND	400	پارامتر لازم ارسال نشده
VALIDATION_ERROR	422	پارامتر آمده ولی نوع، قالب یا بازه‌اش نادرست است
INVALID_SOURCE_LANGUAGE	400	کد زبان مبدأ نامعتبر است
INVALID_TARGET_LANGUAGE	400	کد زبان مقصد نامعتبر است
INVALID_LANGUAGE	400	کد زبان ارسالی نامعتبر است
UPSTREAM_ERROR	502	خطا در پاسخ دریافتی از سرویس بالادستی
TRANSLATION_FAILED	500	خطا در ترجمهٔ متن

لینک های بیشتر

• راهنمای اتصال به سرویس
• فرمت خروجی موفقیت API
• فرمت خروجی خطای API
• کدهای خطای عمومی