WYJERNIE API
Uprość i przetłumacz treść na 24 języki wyjściowe.
Synchroniczny punkt końcowy akceptuje tekst źródłowy, wyjściowe ustawienia regionalne i jeden z dwóch trybów. Automatycznie wykrywa język źródłowy i zwraca gotowy do użycia wynik w wybranym języku wyjściowym.
{
"text": "Kompleksowa treść źródłowa w wybranym języku.",
"locale": "pl",
"mode": "simple-language"
}Dostępne przykłady SDK i cURL
Wynik końcowy
POST /api/v2/translate
Utwórz jeden wynik w języku Plain Language lub Easy Language i zwróć go w tej samej odpowiedzi HTTP.
Wymagane nagłówki
| Wpis | Wymóg | Celem |
|---|---|---|
| Authorization | Bearer <API_KEY> | Uwierzytelnia projekt przy użyciu bieżącego schematu nośnika HTTP |
| Content-Type | wniosek/json | Oświadcza format składu wniosku |
| Accept | wniosek/json | Wymaganie odpowiedzi JSON |
| Idempotency-Key | Wymagane tylko w przypadku zadań i partii | Zapobiega tworzeniu się duplikatów pracy przy powtarzających się, asynchronicznych zgłoszeniach |
Organ wnioskowy
Żadne inne ustawienie treści nie jest częścią schematu żądania publicznego.
| Połowo | Typ | Wymagane | Wartość dopuszczalna | Opis |
|---|---|---|---|---|
| text | wiersz | - Tak . | Od 1 do 10 000 znaków Unicode | Zawartość źródła w wybranej lokalizacji |
| locale | wiersz | - Tak . | Jeden z 24 obsługiwanych kodów dwu liternych | Język wyjściowy. Język źródłowy jest wykrywany automatycznie. |
| mode | wiersz | - Tak . | Prosta, łatwa. | Tryb uproszczenia |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organ odpowiedzi
Odpowiedź nie może zawierać wycofanych ustawień żądań ani oddzielnej tablicy informacji o jakości.
| Połowo | Typ | Opis |
|---|---|---|
| requestId | wiersz | Unikalny identyfikator wsparcia i dzienników |
| locale | wiersz | Wybrane ustawienia regionalne wyjścia |
| mode | wiersz | Wybrany tryb uproszczenia |
| output | wiersz | Gotowy wynik w wybranych ustawieniach wyjściowych |
| usage.inputCharacters | liczba cała | Znaki zliczone dla tego żądania lub 0 dla trafienia w pamięci podręcznej |
| usage.cacheHit | wartość logiczna | Czy wynik pochodzi z 30-dniowej pamięci podręcznej |
{
"requestId": "req_sync_002",
"locale": "en",
"mode": "easy-language",
"output": "You need to send documents.\nSend the documents before the deadline.",
"usage": {
"inputCharacters": 78,
"cacheHit": false
}
}Zachowanie w zakresie weryfikacji
- Brak tekstu: odrzucić z udokumentowanym błędem pola.
- Puste tekst: odrzucić z udokumentowanym błędem pola.
- Niepodpanowana lokalizacja: odrzuć; nigdy nie zastępuj w milczeniu innej lokalizacji.
- Niepodparty tryb: odrzuć; nigdy nie wybieraj tryb automatycznie.
- Nieznane pole zmarne: odrzucić błędem zwrotnym na migrację lub obsługiwać tylko poprzez wyraźnie wprowadzoną wersję warstwy zgodności.
- Tekst źródłowy może używać języka innego niż lokalne. Simple8 automatycznie wykrywa język źródłowy i zapisuje wynik w wybranych ustawieniach wyjściowych.