Dokumentácia

Prvú žiadosť o rozhranie API urobte za pár minút.

Skôr než začnete, uistite sa, že spĺňate tieto tri požiadavky.

{
  "text": "Komplexný zdrojový obsah vo vybranom jazyku.",
  "locale": "sk",
  "mode": "simple-language"
}

K dispozícii sú príklady SDK a cURL

Predbežné podmienky

Aktívny program Scale
Kľúč API
cURL, JavaScript, PHP alebo Python. Ponúkame príklady pre všetky štyri možnosti.

Krok 1: Nastavte kľúč

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

Krok 2: Posielajte žiadosť

Verejné API verzie 2 poskytuje:

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}

Použite https://api.simple8.de vo výrobe. Odošlite kľúč API ako token nosiča zo svojho 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"])

Krok 3: Prečítajte si odpoveď

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

Krok 4: Vyskúšajte druhý režim

Jednoduchý jazyk a jednoduchý jazyk sú rôzne režimy produktu. Vyberte si režim, ktorý vyhovuje ľuďom, ktorých chcete osloviť.

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

Ďalšie kroky

Prehľad všetkých podporovaných lokálnych kódov
Porovnávanie vzoriek doručenia
Prečítajte si usmernenia o overení pravosti
Proces väčších množstiev s podkladovými objednávkami a požiadavkami na zber
Nakonfigurujte koncový bod webhooku v aplikácii
Skontrolujte vyrovnávaciu pamäť, používanie a správanie pri fakturácii

Na tejto stránke

Prvú žiadosť o rozhranie API urobte za pár minút.

Začnite zadarmo používať Simple8.