Dien binnen enkele minuten uw eerste API-verzoek in.

Gebruik uw account, een privé-API-sleutel, een ondersteunde uitvoerlandinstelling en een van de twee taalmodi.

{
  "text": "Complexe broninhoud in de geselecteerde taal.",
  "locale": "nl",
  "mode": "simple-language"
}

SDK- en cURL-voorbeelden beschikbaar

Voorwaarden

Een gratis of betaald Simple8-account met een geverifieerd e-mailadres
Een actieve API-sleutel die in de applicatie is gemaakt
cURL of een van de voorbeeld runtimes
Openbare, niet-vertrouwelijke testinhoud

Stap 1: Stel de sleutel in

export SIMPLE8_API_KEY="replace-with-your-sandbox-key"
export SIMPLE8_API_BASE_URL="https://api.simple8.de"

Stap 2: Stuur het verzoek

De openbare versie 2 API biedt:

POST /api/v2/translate
POST /api/v2/translate/stream
POST /api/v2/jobs
GET /api/v2/jobs/{id}
POST /api/v2/batches
GET /api/v2/batches/{id}

Gebruik https://api.simple8.de in productie. Verzend de API-sleutel als een Bearer-token vanaf uw server.

curl --request POST \
  --url "$SIMPLE8_API_BASE_URL/api/v2/translate" \
  --header "Authorization: Bearer $SIMPLE8_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "text": "To complete the application, submit a valid identity document.",
    "locale": "en",
    "mode": "simple-language"
  }'

const response = await fetch(`${process.env.SIMPLE8_API_BASE_URL}/api/v2/translate`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLE8_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "To complete the application, submit a valid identity document.",
    locale: "en",
    mode: "simple-language"
  })
});

const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error.code}: ${result.error.message}`);
}

console.log(result.output);

<?php

$payload = json_encode([
    "text" => "To complete the application, submit a valid identity document.",
    "locale" => "en",
    "mode" => "simple-language"
]);

$baseUrl = rtrim(getenv("SIMPLE8_API_BASE_URL"), "/");
$request = curl_init($baseUrl . "/api/v2/translate");

curl_setopt_array($request, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("SIMPLE8_API_KEY"),
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => $payload
]);

$response = curl_exec($request);
$status = curl_getinfo($request, CURLINFO_HTTP_CODE);
curl_close($request);

if ($status < 200 || $status >= 300) {
    throw new RuntimeException($response);
}

$result = json_decode($response, true);
echo $result["output"];

import os
import requests

base_url = os.environ["SIMPLE8_API_BASE_URL"].rstrip("/")

response = requests.post(
    f"{base_url}/api/v2/translate",
    headers={
        "Authorization": f"Bearer {os.environ['SIMPLE8_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "text": "To complete the application, submit a valid identity document.",
        "locale": "en",
        "mode": "simple-language",
    },
    timeout=30,
)

response.raise_for_status()
print(response.json()["output"])

Stap 3: Controleer de reactie

{
  "requestId": "req_sync_001",
  "locale": "en",
  "mode": "simple-language",
  "output": "Send a valid identity document with your application.",
  "usage": {
    "inputCharacters": 67,
    "cacheHit": false
  }
}

Stap 4: Probeer de tweede modus

Plain Language en Easy Language zijn verschillende productmodi. Kies de modus die past bij de mensen die u wilt bereiken.

{
  "mode": "easy-language"
}

Volgende stappen

Alle ondersteunde lokaalcodes bekijken
Vergelijk de afleveringspatronen
Lees de handleiding voor authenticatie
Creëer taken en batches voor grotere workflows
Configureer een webhookeindpunt in de toepassing
Controleer cache, gebruik en factureringsgedrag

Op deze pagina