Documentation

Choisissez comment votre système reçoit le résultat.

{
  "text": "Contenu source complexe dans la langue sélectionnée.",
  "locale": "fr",
  "mode": "simple-language"
}

Exemples de SDK et cURL disponibles

HTTP synchrone

Chaque modèle utilise les mêmes champs principaux : texte, paramètres régionaux et mode.

Point de terminaison

POST /api/v2/translate

Idéal pour

Contenu court et actions backend directes.

Succès

200 OK

Diffusion en continu

La réponse utilise Content-Type : text/event-stream.

Point de terminaison

POST /api/v2/translate/stream

Idéal pour

Interfaces progressives et contenu plus long.

{
  "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}}

Le flux émet un méta-événement, un ou plusieurs événements delta et un événement final terminé.

L'événement méta contient l'identifiant de la demande, les paramètres régionaux et le mode.

Chaque delta contient une partie du résultat et done contient les informations d'utilisation.

Une fois terminé, la connexion se ferme.

Travail asynchrone avec sondage

Envoyez un en-tête Idempotency-Key unique lors de la création d’un travail.

Créer un point de terminaison

POST /api/v2/jobs

Point de terminaison d'état

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."
  }
}

Les emplois restent disponibles pendant sept jours.

Interrogez à un intervalle raisonnable jusqu'à ce que le statut soit terminé ou échoué.

Travail asynchrone avec webhook

Créez et vérifiez d'abord un point de terminaison webhook dans l'application Simple8. Référencez ensuite son ID de point de terminaison dans le travail.

Créer un point de terminaison

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 envoie un en-tête Simple8-Signature avec un horodatage et une signature HMAC SHA-256.

Vérifiez la signature par rapport au corps brut de la demande avec le secret de signature affiché une fois lors de la création du point de terminaison.

Renvoyez n’importe quel statut 2xx après avoir accepté l’événement.

Les livraisons ayant échoué sont réessayées jusqu'à 50 fois sur sept jours, et les tentatives récentes sont visibles dans l'application.

Les destinataires doivent tolérer la livraison en double, car les nouvelles tentatives peuvent transmettre le même événement plusieurs fois.

Traitement par lots

Envoyez entre 1 et 50 éléments avec un maximum combiné de 500 000 caractères.

Créer un point de terminaison

POST /api/v2/batches

Point de terminaison d'état

GET /api/v2/batches/{id}

Chaque élément utilise les mêmes champs de texte, de paramètres régionaux et de mode qu'une requête synchrone.

Choisissez une interrogation ou un point de terminaison de webhook vérifié pour la livraison et envoyez un en-tête Idempotency-Key unique.

Sur cette page