Komma igång

Använd PolyLingo HTTP API för att översätta ren text, Markdown, JSON eller HTML samtidigt som strukturen bevaras. Denna guide täcker produktionsendpoint, autentisering och din första lyckade förfrågan.

Bas-URL

Alla exempel använder produktions-API:

Varje sökväg nedan är relativ till basen (till exempel betyder POST /translate POST https://api.usepolylingo.com/v1/translate).

Om du kör din egna PolyLingo API-instans, ersätt värden med din deploy-URL och behåll /v1 prefixet om du inte konfigurerat annorlunda.

Autentisering

Skyddade endpoints förväntar sig din API-nyckel i Authorization-huvudet:

Authorization: Bearer <your_api_key>

Få en nyckel: Skapa en i PolyLingo-appen under API keys. Du ser hela nyckeln bara en gång—spara den på ett säkert ställe (miljövariabel eller hemlighetshanterare). Nycklar kan återkallas från samma skärm.

Säkerhet: Behandla nyckeln som ett lösenord. Föredra att anropa API:et från din server, inte från publik webbläsarkod, så att nyckeln aldrig exponeras för användare.

Om huvudet saknas, är felaktigt, eller nyckeln är ogiltig eller återkallad, svarar API:et med 401 och error: "invalid_api_key".

Endpoints och nycklar

Första förfrågan (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"
  }'

Ett lyckat svar inkluderar ett translations-objekt (en post per mål språk du begärt) och ett usage-objekt med tokenräkningar.

Första förfrågan (Node.js)

Node.js 18+ inkluderar 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)

Kontrollera att API:et är nåbart

Ingen nyckel behövs för health:

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

Du bör se en liten JSON-payload som indikerar att tjänsten är uppe. Använd GET /languages för listan över koder du kan skicka som targets.

CORS och webbläsarappar

API:et kan begränsa vilka webbläsarorigin som kan anropa det direkt, så att nycklar inte används från opålitliga webbplatser. Server-sidiga anrop (Node, Python, edge-funktioner, din backend) är inte begränsade av CORS.

För en single-page app är det vanliga mönstret: din frontend pratar med din backend, och din backend anropar PolyLingo med API-nyckeln.

Nästa steg

• API-referens — förfrågnings- och svarsscheman, format, fel och begränsningar.