Başlarken

PolyLingo HTTP API'sini kullanarak düz metin, Markdown, JSON veya HTML çevirisi yapabilir ve yapıyı koruyabilirsiniz. Bu rehber, üretim uç noktasını, kimlik doğrulamayı ve ilk başarılı isteğinizi kapsar.

Temel URL

Tüm örnekler üretim API'sini kullanır:

URL
Üretimhttps://api.usepolylingo.com/v1

Aşağıdaki her yol bu temel URL'ye göredir (örneğin, POST /translate demek POST https://api.usepolylingo.com/v1/translate anlamına gelir).

Kendi PolyLingo API örneğinizi çalıştırıyorsanız, ana bilgisayarı dağıtım URL'nizle değiştirin ve /v1 önekini değiştirmediyseniz koruyun.

Kimlik Doğrulama

Korunan uç noktalar API anahtarınızı Authorization başlığında bekler:

Authorization: Bearer <your_api_key>

Anahtar alma: PolyLingo uygulamasında API anahtarları altında bir tane oluşturun. Anahtarın tamamını yalnızca bir kez görürsünüz—güvenli bir yerde saklayın (ortam değişkeni veya gizli yönetici). Anahtarlar aynı ekrandan iptal edilebilir.

Güvenlik: Anahtarı bir şifre gibi ele alın. Anahtarın kullanıcıya asla açığa çıkmaması için API'yi sunucunuzdan çağırmayı tercih edin, halka açık tarayıcı kodundan değil.

Başlık eksik, yanlış veya anahtar geçersiz ya da iptal edilmişse, API 401 ve error: "invalid_api_key" ile yanıt verir.

Uç Noktalar ve Anahtarlar

Anahtar gerekmezGET /health — hızlı çalışma süresi kontrolü
GET /languages — desteklenen dil kodları
Anahtar gerekirPOST /translate — içeriği çevir
POST /translate/batch — birden fazla öğeyi çevir
POST /jobs — uzun süren çeviri kuyruğa al (hemen 202 döner)
GET /jobs/:id — iş durumunu sorgula; beklerken queue_position içerir
GET /usage — kimlik doğrulanmış hesap kullanımı

İlk İstek (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"
  }'

Başarılı yanıt, istediğiniz hedef diller için birer giriş içeren translations nesnesi ve token sayılarıyla birlikte bir usage nesnesi içerir.

İlk İstek (Node.js)

Node.js 18+ fetch içerir:

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'nin erişilebilir olduğunu kontrol edin

Sağlık için anahtar gerekmez:

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

Servisin çalıştığını gösteren küçük bir JSON yükü görmelisiniz. targets olarak geçirebileceğiniz kodların listesi için GET /languages kullanın.

CORS ve tarayıcı uygulamaları

API, anahtarların güvensiz sitelerden kullanılmaması için hangi tarayıcı kaynaklarının doğrudan çağırabileceğini kısıtlayabilir. Sunucu tarafı çağrılar (Node, Python, edge fonksiyonları, backend) CORS ile sınırlı değildir.

Tek sayfa uygulaması için yaygın desen: ön yüzünüz backend'inizle konuşur ve backend PolyLingo'yu API anahtarıyla çağırır.

Sonraki adımlar

  • API referansı — istek ve yanıt şekilleri, formatlar, hatalar ve limitler.
Başlarken | PolyLingo | PolyLingo