Documentation Développeurs

Widget Embed (Iframe)

Intégrez dynamiquement l'arbre de dépendance d'un projet directement sur votre site web via une simple balise <iframe>.

<iframe 
    src="https://opentree.appel.ovh/embed/PROJECT_ID" 
    width="100%" 
    height="500" 
    frameborder="0"
    allowtransparency="true"
></iframe>
        

Exemple de rendu réel : Voir la démo de l'Iframe

Paramètres URL (Options)

Personnalisez le rendu en ajoutant des paramètres à la fin de l'URL : ?param=valeur

Paramètre	Valeurs supportées	Description
`theme`	`light`, `dark`	Force le thème clair ou sombre. Par défaut: light.
`controls`	`1`, `0`	Affiche (1) ou masque (0) les contrôles de zoom/pan. Par défaut: 1.
`interactive`	`1`, `0`	Active (1) ou désactive (0) le zoom, le pan et les clics sur les nœuds. Par défaut: 1.
`search`	`1`, `0`	Affiche (1) ou masque (0) la barre de recherche dans l'iframe. Par défaut: 0.
`global_search`	`1`, `0`	Si activé (1), la barre de recherche permet de chercher dans toute la base de données. Au clic, l'Iframe se mettra à jour avec le nouveau projet. Par défaut: 0.
`infos`	`1`, `0`	Si activé (1), cliquer sur un nœud ouvre le panneau d'informations directement dans l'iframe. Par défaut: 0.
`comments` NEW	`1`, `0`	Si activé (1), le panneau d'infos affiche le bouton Avis & Discussions. Nécessite `infos=1`. Par défaut: 0 (caché pour des intégrations propres). Les boutons Éditer et Ajouter sont toujours masqués en mode embed.
`move`	`1`, `0`	Si activé (1), l'utilisateur peut déplacer manuellement (glisser-déposer) les nœuds du graphe. Par défaut: 0.
`color`	Ex: `#ff0000`	Remplace la couleur principale de l'interface (thème).
`init_zoom`	Ex: `0.8`	Définit le niveau de zoom initial. Surcharge le centrage automatique s'il est défini.
`init_x` / `init_y`	Ex: `200`	Définit la position initiale (pan) de la caméra. Surcharge le centrage automatique.
`spacing_x`	Ex: `0.5`	Multiplicateur d'espacement horizontal pour resserrer ou étendre l'arbre. Par défaut: 0.5 (compressé 2x).
`spacing_y`	Ex: `0.5`	Multiplicateur d'espacement vertical pour resserrer ou étendre l'arbre. Par défaut: 0.5 (compressé 2x).

<!-- Exemple : Thème sombre, sans contrôles, panneau info avec commentaires -->
<iframe src="https://opentree.appel.ovh/embed/firefox?theme=dark&controls=0&infos=1&comments=1" width="100%" height="600" frameborder="0"></iframe>
        

<!-- Exemple : Embed propre sans boutons d'édition ni discussions -->
<iframe src="https://opentree.appel.ovh/embed/linux?infos=1&comments=0" width="100%" height="500" frameborder="0"></iframe>
        

API REST

Tous les endpoints de l'API sont accessibles sous /api/. Les réponses suivent le format standard {"status": "success", "data": ...}.

Endpoint	Méthode	Description
`/api/graph/full`	`GET`	Retourne le graphe complet (tous les nœuds et arêtes).
`/api/graph/subgraph/{id}`	`GET`	Retourne le sous-graphe centré sur le projet ayant l'ID donné (ancêtres + descendants).
`/api/projects/{id}`	`GET`	Retourne les détails complets d'un projet.
`/api/search?q={query}`	`GET`	Recherche des projets par nom. Retourne une liste de correspondances.