Ξεκινώντας

Χρησιμοποιήστε το PolyLingo HTTP API για να μεταφράσετε απλό κείμενο, Markdown, JSON ή HTML διατηρώντας τη δομή ανέπαφη. Αυτός ο οδηγός καλύπτει το production endpoint, την αυθεντικοποίηση και το πρώτο σας επιτυχημένο αίτημα.

Βασικό URL

Όλα τα παραδείγματα χρησιμοποιούν το production API:

Κάθε διαδρομή παρακάτω είναι σχετική με αυτή τη βάση (για παράδειγμα, POST /translate σημαίνει POST https://api.usepolylingo.com/v1/translate).

Αν τρέχετε τη δική σας PolyLingo API εγκατάσταση, αντικαταστήστε το host με το URL της ανάπτυξής σας και κρατήστε το πρόθεμα /v1 εκτός αν έχετε ρυθμίσει διαφορετικά.

Αυθεντικοποίηση

Τα προστατευμένα endpoints αναμένουν το API key σας στην κεφαλίδα Authorization:

Authorization: Bearer <your_api_key>

Λήψη κλειδιού: Δημιουργήστε ένα στην εφαρμογή PolyLingo κάτω από API keys. Βλέπετε το πλήρες κλειδί μόνο μία φορά—αποθηκεύστε το κάπου ασφαλές (μεταβλητή περιβάλλοντος ή διαχειριστή μυστικών). Τα κλειδιά μπορούν να ανακληθούν από την ίδια οθόνη.

Ασφάλεια: Αντιμετωπίστε το κλειδί σαν κωδικό πρόσβασης. Προτιμήστε να καλείτε το API από τον διακομιστή σας, όχι από δημόσιο κώδικα browser, ώστε το κλειδί να μην εκτίθεται στους χρήστες.

Αν η κεφαλίδα λείπει, είναι λάθος ή το κλειδί είναι άκυρο ή ανακλημένο, το API απαντά με 401 και error: "invalid_api_key".

Endpoints και κλειδιά

Πρώτο αίτημα (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 με μετρήσεις tokens.

Πρώτο αίτημα (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 είναι προσβάσιμο

Δεν απαιτείται κλειδί για το health:

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

Θα δείτε ένα μικρό JSON που υποδεικνύει ότι η υπηρεσία λειτουργεί. Χρησιμοποιήστε GET /languages για τη λίστα κωδικών που μπορείτε να περάσετε ως targets.

CORS και εφαρμογές browser

Το API μπορεί να περιορίζει ποια προέλευση browser μπορεί να το καλεί απευθείας, ώστε τα κλειδιά να μην χρησιμοποιούνται από μη αξιόπιστους ιστότοπους. Οι κλήσεις από server (Node, Python, edge functions, backend σας) δεν περιορίζονται από CORS.

Για μια single-page εφαρμογή, το συνηθισμένο μοτίβο είναι: το frontend σας μιλάει με το backend σας, και το backend καλεί το PolyLingo με το API key.

Επόμενα βήματα

• API reference — σχήματα αιτημάτων και απαντήσεων, μορφές, σφάλματα και όρια.