Sources personnalisées

Connectez vos API internes ou bases de données via un simple endpoint HTTPS.

Quand l’utiliser ?

• Application métier sans connecteur natif.
• API REST offrant du JSON.
• Script maison qui renvoie la liste des documents à indexer.

Prérequis

• Endpoint sécurisé (HTTPS) accessible depuis Hestyna.
• Méthode GET ou POST supportée.
• Clé API ou token pour authentifier les requêtes.
• Corps JSON structuré :

{
  "items": [
    {
      "id": "DOC-1",
      "title": "Procédure sécurité",
      "body": "Texte...",
      "language": "fr",
      "tags": {"service": "security"}
    }
  ]
}

Configuration dans Hestyna

1. Catalogue → Intégrations → Source personnalisée.
2. Renseignez :
   • endpoint (URL),
   • method (GET ou POST),
   • headers (ex. Authorization: Bearer ...),
   • items_path (chemin vers le tableau, ex. items),
   • title_field, body_field, language, etc.
3. Testez la connexion.

Créer un index

1. Connaissance → Indexes → sélectionnez votre source personnalisée.
2. Ajoutez des paramètres de filtre si votre API en accepte (?service=it).
3. Lancez la synchronisation.

Sécurité

• Utilisez des tokens à courte durée de vie si possible.
• Restreignez l’IP source d’Hestyna si votre infrastructure le permet.
• Masquez les informations sensibles avant de renvoyer le JSON.

Dépannage

Problème	Solution
400 Bad Request	Vérifiez le format JSON renvoyé.
401 Unauthorized	Token expiré ou en-tête manquant.
Données incomplètes	Ajustez items_path, title_field, body_field.

Besoin d’aide ? Contactez l’équipe Customer Success avec un exemple de payload et la réponse attendue.