Documentation

Guide de la plateforme

Interface de chat

L'interface de chat offre une expérience d'IA conversationnelle, avec des réponses diffusées en continu. Saisissez votre message et appuyez sur Entrée pour l'envoyer. L'IA parle sango, français et anglais, et vous aide à apprendre le vocabulaire, la grammaire et le contexte culturel.

Traduction

Traduisez du texte entre le sango, le français et l'anglais : quatre directions (FR→SG, EN→SG, SG→FR, SG→EN), plus la détection automatique de la langue source. L'IA fournit des traductions contextuelles, attentives à la culture.

Vocabulaire et apprentissage

La page Apprendre propose des centaines de mots sango vérifiés, avec guides de prononciation, cartes mémoire, quiz et exercices à trous, classés par catégorie (salutations, nombres, couleurs, famille, nourriture, etc.) et par niveau de difficulté.

Raccourcis Clavier

• Entrée — Envoyer le message
• Maj + Entrée — Nouvelle ligne

Référence API

Les points de terminaison de traduction et de vocabulaire sont accessibles publiquement, sans authentification. Le point de terminaison de chat nécessite un jeton JWT. Consultez le portail développeurs pour des exemples de code fonctionnels.

POST /api/v1/translate

Traduit du texte entre le français, l'anglais et le sango. Aucune authentification requise.

Corps de la requête

{
  "text": "Bonjour, comment allez-vous?",
  "source_language": "french",   // "french" | "sango" | "english" | "auto"
  "target_language": "sango",    // "french" | "sango" | "english"
  "include_alternatives": false  // optional
}

Réponse (200)

{
  "translated_text": "Bara âla, tongana nye?",
  "source_language": "french",
  "target_language": "sango",
  "word_count": 3,
  "confidence": 0.95
}

POST /api/v1/vocabulary/search

Recherche dans la base de vocabulaire sango vérifié. Renvoie les mots correspondants, avec guides de prononciation et phrases d'exemple. Aucune authentification requise.

Corps de la requête

{
  "query": "hello",       // search term
  "limit": 10,            // max results (default 10)
  "status": "verified"    // filter by status
}

Réponse (200)

{
  "words": [{
    "word_id": "gree-903",
    "sango": "bala ala",
    "french": "bonjour",
    "english": "hello",
    "category": "greetings",
    "difficulty": "beginner",
    "pronunciation_guide": "Ba-la ala"
  }],
  "count": 1,
  "total_available": 600
}

GET /api/v1/vocabulary/random/{count}

Renvoie des mots de vocabulaire vérifiés, tirés au hasard. Utile pour les quiz et les cartes mémoire. Aucune authentification requise.

Réponse (200)

{
  "words": [{
    "word_id": "colo-951",
    "sango": "sango ya nzöngo",
    "french": "jaune",
    "english": "yellow",
    "category": "colors",
    "difficulty": "beginner"
  }],
  "count": 5
}

POST /api/v1/chat

Assistant de langue sango propulsé par l'IA. Nécessite une authentification (jeton JWT).

En-têtes

Authorization: Bearer <JWT_TOKEN>
Content-Type: application/json

Corps de la requête

{
  "message": "How do you say goodbye in Sango?",
  "mode": "learning"
}

Authentification

• Points d'accès publics (traduction, vocabulaire) : Aucune authentification requise. Envoyez simplement votre demande.
• Points d'accès protégés (chat, progression utilisateur) : Nécessitent un en-tête Authorization: Bearer <JWT>. Les utilisateurs s'authentifient via Google OAuth ou email/mot de passe sur l'application Web SangoAI.
• Clés d'API : l'API à clé (https://api.sangoai.app, en-tête X-API-Key) a ses propres offres, quotas et limites de débit — voir Clés d'API et tarifs.

Gestion des erreurs

Prise en charge des langues

Langues prises en charge

• Sango (Sängö) — langue co-officielle de la République centrafricaine (avec le français)
• Français — langue co-officielle de la RCA, avec le sango
• Anglais — pour les utilisateurs internationaux

Orthographe du sango

SangoAI utilise l'orthographe standard du sango, avec ses diacritiques : â, ê, ë, î, ö, ô, û, ü, ï. Le moteur de traduction tolère les saisies sans accents.

Confidentialité

Les textes que vous traduisez et les messages envoyés à l'assistant sont transmis à nos serveurs pour être traités. Les prestataires qui les traitent pour notre compte — comme l'hébergement et l'infrastructure — agissent selon nos seules instructions et ne peuvent pas utiliser vos données à leurs propres fins. N'y saisissez pas d'informations personnelles ou confidentielles. Notre politique de confidentialité fait foi.