Документация

Изберете как системата ви получава резултата.

{
  "text": "Сложно изходно съдържание на избрания език.",
  "locale": "bg",
  "mode": "simple-language"
}

Налични са примери за SDK и cURL

Синхронна HTTP

Всеки шаблон използва едни и същи основни полета: текст, локал и режим.

Крайна точка

POST /api/v2/translate

Най-добре за

Кратко съдържание и директни действия в обратния край.

Успех

200 ОК

Съпровождане

Отговорът използва Content-Type: text/event-stream.

Крайна точка

POST /api/v2/translate/stream

Най-добре за

Прогресивни интерфейси и по-дълъг съдържание.

{
  "text": "Source content in the selected language.",
  "locale": "en",
  "mode": "easy-language"
}

event: meta
data: {"requestId":"req_stream_001","locale":"en","mode":"easy-language"}

event: delta
data: {"delta":"Complete result."}

event: done
data: {"usage":{"inputCharacters":42,"cacheHit":false}}

Потокът излъчва едно мета събитие, едно или повече делта събития и окончателно готово събитие.

Мета събитието съдържа идентификатора на заявката, локала и режима.

Всяка делта съдържа част от резултата, а done съдържа информацията за употребата.

След като приключи, връзката се затваря.

Асинхронизирана работа с анкетиране

Изпратете уникален хедър Idempotency-Key, когато създавате задание.

Създаване на крайна точка

POST /api/v2/jobs

Стойност на крайната точка

GET /api/v2/jobs/{id}

{
  "text": "Source content in the selected language.",
  "locale": "fr",
  "mode": "simple-language",
  "delivery": {
    "type": "polling"
  }
}

{
  "jobId": "job_poll_001",
  "status": "queued"
}

{
  "jobId": "job_poll_001",
  "status": "completed",
  "locale": "fr",
  "mode": "simple-language",
  "output": {
    "text": "Simplified content in French."
  }
}

Работните места остават налични за седем дни.

Анкета на разумен интервал, докато статусът бъде завършен или неуспешен.

Работа с Async с webhook

Първо създайте и проверете крайна точка на webhook в приложението Simple8. След това посочете неговия идентификатор на крайна точка в заданието.

Създаване на крайна точка

POST /api/v2/jobs

{
  "text": "Source content in the selected language.",
  "locale": "de",
  "mode": "easy-language",
  "delivery": {
    "type": "webhook",
    "endpointId": "00000000-0000-4000-8000-000000000000"
  }
}

{
  "id": "evt_01",
  "type": "job.completed",
  "createdAt": "2026-08-06T12:00:00.000Z",
  "data": {
    "jobId": "job_hook_001",
    "status": "completed"
  }
}

Simple8 изпраща заглавка Simple8-Signature с клеймо за време и HMAC SHA-256 подпис.

Проверете подписа спрямо тялото на необработената заявка с тайната за подписване, показана веднъж, когато крайната точка е създадена.

Връща всеки статус 2xx след приемане на събитието.

Неуспешните доставки се опитват до 50 пъти за седем дни, а последните опити се виждат в приложението.

Получателите трябва да толерират дублирана доставка, тъй като повторните опити могат да доставят едно и също събитие повече от веднъж.

Пакетна обработка

Изпратете между 1 и 50 елемента с общ максимум от 500 000 знака.

Създаване на крайна точка

POST /api/v2/batches

Стойност на крайната точка

GET /api/v2/batches/{id}

Всеки елемент използва същия текст, локал и полета за режим като синхронна заявка.

Изберете анкета или потвърдена крайна точка на уебкукичка за доставка и изпратете уникална заглавка Idempotency-Key.

На тази страница