Kom godt i gang

Brug PolyLingo HTTP API til at oversætte ren tekst, Markdown, JSON eller HTML samtidig med at strukturen bevares. Denne guide dækker produktions-endpointet, autentificering og din første succesfulde forespørgsel.

Basis-URL

Alle eksempler bruger produktions-API'et:

Hver sti nedenfor er relativ til denne base (for eksempel betyder POST /translate POST https://api.usepolylingo.com/v1/translate).

Hvis du kører din egen PolyLingo API-instans, skal du erstatte hosten med din deployments-URL og beholde /v1-præfikset, medmindre du har konfigureret andet.

Autentificering

Beskyttede endpoints forventer din API-nøgle i Authorization-headeren:

Authorization: Bearer <your_api_key>

Få en nøgle: Opret en i PolyLingo-appen under API keys. Du ser den fulde nøgle kun én gang—gem den et sikkert sted (miljøvariabel eller hemmelighedshåndtering). Nøgler kan tilbagekaldes fra samme skærm.

Sikkerhed: Behandl nøglen som en adgangskode. Foretræk at kalde API'et fra din server, ikke fra offentlig browserkode, så nøglen aldrig udsættes for brugere.

Hvis headeren mangler, er forkert, eller nøglen er ugyldig eller tilbagekaldt, svarer API'et med 401 og error: "invalid_api_key".

Endpoints og nøgler

Første forespørgsel (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"
  }'

Et succesfuldt svar inkluderer et translations-objekt (én post pr. målsprog, du har anmodet om) og et usage-objekt med token-tællinger.

Første forespørgsel (Node.js)

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

Tjek at API'et er tilgængeligt

Ingen nøgle er nødvendig for sundhed:

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

Du bør se en lille JSON-payload, der indikerer, at tjenesten kører. Brug GET /languages for listen over koder, du kan sende som targets.

CORS og browser-apps

API'et kan begrænse, hvilke browser-origin der kan kalde det direkte, så nøgler ikke bruges fra utroværdige sider. Server-side kald (Node, Python, edge-funktioner, din backend) er ikke begrænset af CORS.

For en single-page app er det sædvanlige mønster: din frontend taler med din backend, og din backend kalder PolyLingo med API-nøglen.

Næste skridt

• API reference — anmodnings- og svarformater, fejl og grænser.