শুরু করা

PolyLingo HTTP API ব্যবহার করে সাধারণ টেক্সট, Markdown, JSON, অথবা HTML অনুবাদ করুন এবং কাঠামো অক্ষুণ্ণ রাখুন। এই গাইডটি প্রোডাকশন এন্ডপয়েন্ট, প্রমাণীকরণ, এবং আপনার প্রথম সফল অনুরোধ কভার করে।

বেস URL

সব উদাহরণ প্রোডাকশন API ব্যবহার করে:

URL
প্রোডাকশনhttps://api.usepolylingo.com/v1

নিচের প্রতিটি পাথ ঐ বেসের আপেক্ষিক (উদাহরণস্বরূপ, POST /translate মানে POST https://api.usepolylingo.com/v1/translate)।

আপনি যদি আপনার নিজস্ব PolyLingo API ইনস্ট্যান্স চালান, তাহলে হোস্টটি আপনার ডিপ্লয়মেন্ট URL দিয়ে প্রতিস্থাপন করুন এবং /v1 প্রিফিক্স রাখুন যদি না আপনি অন্যভাবে কনফিগার করে থাকেন।

প্রমাণীকরণ

সুরক্ষিত এন্ডপয়েন্টগুলি আপনার API কী Authorization হেডারে আশা করে:

Authorization: Bearer <your_api_key>

কী পাওয়া: PolyLingo অ্যাপে API keys এর অধীনে একটি তৈরি করুন। আপনি সম্পূর্ণ কী একবারই দেখতে পাবেন—এটি কোথাও নিরাপদে সংরক্ষণ করুন (পরিবেশ ভেরিয়েবল বা সিক্রেট ম্যানেজার)। একই স্ক্রীন থেকে কী বাতিল করা যেতে পারে।

নিরাপত্তা: কীকে পাসওয়ার্ডের মতো বিবেচনা করুন। API কল করা ভাল আপনার সার্ভার থেকে, পাবলিক ব্রাউজার কোড থেকে নয়, যাতে কী ব্যবহারকারীদের কাছে কখনো প্রকাশ না হয়।

যদি হেডার অনুপস্থিত, ভুল, অথবা কী অবৈধ বা বাতিল হয়, API 401 এবং error: "invalid_api_key" দিয়ে প্রতিক্রিয়া দেয়।

এন্ডপয়েন্ট এবং কী

কোন কী প্রয়োজন নেইGET /health — দ্রুত আপটাইম চেক
GET /languages — সমর্থিত ভাষার কোড
কী প্রয়োজনPOST /translate — বিষয়বস্তু অনুবাদ করুন
POST /translate/batch — একাধিক আইটেম অনুবাদ করুন
POST /jobs — দীর্ঘমেয়াদী অনুবাদের জন্য কাজ যুক্ত করুন (তৎক্ষণাৎ 202 ফেরত দেয়)
GET /jobs/:id — কাজের অবস্থা পোল করুন; অপেক্ষার সময় queue_position অন্তর্ভুক্ত থাকে
GET /usage — প্রমাণীকৃত অ্যাকাউন্টের ব্যবহার

প্রথম অনুরোধ (cURL)

export POLYLINGO_API_KEY="pl_your_key_here"

curl -sS -X POST "https://api.usepolylingo.com/v1/translate" \
  -H "Authorization: Bearer $POLYLINGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "# Hello\n\nThis is **bold**.",
    "format": "markdown",
    "targets": ["es", "fr"],
    "model": "standard"
  }'

সফল প্রতিক্রিয়ায় একটি translations অবজেক্ট থাকে (আপনি যে লক্ষ্য ভাষাগুলি অনুরোধ করেছেন প্রতিটির জন্য একটি এন্ট্রি) এবং একটি usage অবজেক্ট থাকে টোকেন গণনা সহ।

প্রথম অনুরোধ (Node.js)

Node.js 18+ এ fetch অন্তর্ভুক্ত:

const API_KEY = process.env.POLYLINGO_API_KEY
const res = await fetch('https://api.usepolylingo.com/v1/translate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${API_KEY}`,
  },
  body: JSON.stringify({
    content: '# Hello\n\n**Bold** text.',
    format: 'markdown',
    targets: ['de', 'ja'],
    model: 'standard',
  }),
})
const data = await res.json()
if (!res.ok) throw new Error(`${data.error}: ${data.message}`)
console.log(data.translations)

API পৌঁছানো যাচাই করুন

স্বাস্থ্য পরীক্ষার জন্য কী প্রয়োজন নেই:

curl -sS "https://api.usepolylingo.com/v1/health"

আপনি একটি ছোট JSON পে-লোড দেখতে পাবেন যা পরিষেবাটি চালু আছে নির্দেশ করে। আপনি GET /languages ব্যবহার করে কোডের তালিকা পেতে পারেন যা আপনি targets হিসাবে দিতে পারেন।

CORS এবং ব্রাউজার অ্যাপ

API সীমাবদ্ধ করতে পারে কোন ব্রাউজার উৎস সরাসরি কল করতে পারে, যাতে কী অবিশ্বাস্য সাইট থেকে ব্যবহার না হয়। সার্ভার-সাইড কল (Node, Python, edge functions, আপনার ব্যাকএন্ড) CORS দ্বারা সীমাবদ্ধ নয়।

একটি সিঙ্গেল-পেজ অ্যাপ এর জন্য, সাধারণ প্যাটার্ন হল: আপনার ফ্রন্টএন্ড আপনার ব্যাকএন্ড এর সাথে কথা বলে, এবং আপনার ব্যাকএন্ড PolyLingo কে API কী দিয়ে কল করে।

পরবর্তী ধাপ

  • API রেফারেন্স — অনুরোধ এবং প্রতিক্রিয়া ফর্ম, ফরম্যাট, ত্রুটি, এবং সীমা।
শুরু করা | পলিলিঙ্গো | PolyLingo