התחלה

השתמש ב-PolyLingo HTTP API כדי לתרגם טקסט פשוט, Markdown, JSON, או HTML תוך שמירה על המבנה. מדריך זה מכסה את נקודת הקצה של הייצור, אימות, והבקשה הראשונה שלך שהצליחה.

כתובת בסיס

כל הדוגמאות משתמשות ב-API של הייצור:

כל הנתיב למטה הוא יחסית לבסיס זה (לדוגמה, POST /translate משמעותו POST https://api.usepolylingo.com/v1/translate).

אם אתה מפעיל את מופע ה-PolyLingo API שלך, החלף את המארח בכתובת הפריסה שלך ושמור על הקידומת /v1 אלא אם כן הגדרת אחרת.

אימות

נקודות קצה מוגנות מצפות למפתח ה-API שלך בכותרת Authorization:

Authorization: Bearer <your_api_key>

קבלת מפתח: צור אחד באפליקציית PolyLingo תחת API keys. אתה רואה את המפתח המלא רק פעם אחת—שמור אותו במקום בטוח (משתנה סביבה או מנהל סודות). ניתן לבטל מפתחות מאותו מסך.

אבטחה: התייחס למפתח כמו לסיסמה. העדף לקרוא ל-API מהשרת שלך, לא מקוד דפדפן ציבורי, כדי שהמפתח לא ייחשף למשתמשים.

אם הכותרת חסרה, שגויה, או שהמפתח לא תקין או בוטל, ה-API מחזיר 401 ו-error: "invalid_api_key".

נקודות קצה ומפתחות

בקשה ראשונה (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, ה-backend שלך) אינן מוגבלות על ידי CORS.

לאפליקציית דף יחיד, התבנית הרגילה היא: ה-frontend שלך מדבר עם ה-backend שלך, וה-backend שלך קורא ל-PolyLingo עם מפתח ה-API.

השלבים הבאים

• API reference — צורות בקשה ותגובה, פורמטים, שגיאות ומגבלות.