Dokumentācija

Veiciet savu pirmo API pieprasījumu dažu minūšu laikā.

Pirms sākat, pārliecinieties, ka ir izpildītas šīs trīs prasības.

{
  "text": "Sarežģīts avota saturs atlasītajā valodā.",
  "locale": "lv",
  "mode": "simple-language"
}

Pieejami SDK un cURL piemēri

Prasības

Aktīvs Scale plāns
API atslēga
cURL, JavaScript, PHP vai Python. Mēs piedāvājam piemērus visiem četriem variantiem.

1. posms: Pasākums

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

2. posms: nosūtīt pieprasījumu

Publiskā 2. versijas API nodrošina:

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}

Ražošanā izmantojiet https://api.simple8.de. Nosūtiet API atslēgu kā nesēja marķieri no sava servera.

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"])

3. posms: Izmeklē atbildes uz jautājumiem

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

4. posms: mēģiniet otro režīmu

Plain Language un Easy Language ir dažādi produkta režīmi. Izvēlieties režīmu, kas ir piemērots cilvēkiem, kurus vēlaties sasniegt.

{
  "text": "To complete the application, submit a valid identity document.",
  "locale": "en",
  "mode": "easy-language"
}

Nākamais posms

Izskatīt visus atbalstītos lokālo kodu
Apmērināt piegādes veidus
Skaityti autentizācijas vadlīniju
Apstrādāt lielākus daudzumus ar iepriekšējiem pasūtījumiem un savākšanas pieprasījumiem
Lietojumprogrammā konfigurējiet tīmekļa aizķeres galapunktu
Pārskatiet kešatmiņu, lietojumu un norēķinu darbību

Šajā lapā

Veiciet savu pirmo API pieprasījumu dažu minūšu laikā.

Sāciet lietot Simple8 bez maksas.