Reference API

En bref

Ontologie expose une API REST complete pour integrer la plateforme a vos outils. Authentifiez vos requetes, consultez les endpoints disponibles et automatisez vos processus.

Prerequis techniques

Une cle API active (consultez le Guide des cles API).
L'identifiant UUID de votre workspace.
Un client HTTP (curl, Postman, Insomnia ou equivalent).

Explorez vos endpoints dans l'application : le module API Manager vous permet de tester et simuler tous les endpoints generes par votre ontologie, directement depuis l'application.

Portail Client — Reference API complete

Pour acceder a la documentation interactive complete de tous les endpoints (schemas, exemples, sandbox), ainsi qu'au SDK et a la documentation MCP, connectez-vous au Portail Client.

L'acces au portail est reserve aux clients disposant d'un compte actif. Devenir client →

URL de base

https://api.ontologie-growthsystemes.com

Authentification

Tous les endpoints requierent une cle API. Deux methodes sont acceptees :

Methode 1 : Header `X-API-Key` (recommande)

curl "https://api.ontologie-growthsystemes.com/api/queries/nodes" \
  -H "X-API-Key: df_xxxxxxxxxxxxxxxxxxxx" \
  -H "x-workspace-id: 550e8400-e29b-41d4-a716-446655440000"

Methode 2 : Header `Authorization: Bearer`

curl "https://api.ontologie-growthsystemes.com/api/queries/nodes" \
  -H "Authorization: Bearer df_xxxxxxxxxxxxxxxxxxxx" \
  -H "x-workspace-id: 550e8400-e29b-41d4-a716-446655440000"

Les deux methodes sont equivalentes. Utilisez X-API-Key pour la clarte, ou Authorization: Bearer si votre client HTTP l'exige.

Headers requis

Header	Requis	Description
`X-API-Key` ou `Authorization`	Oui	`df_xxx` ou `Bearer df_xxx`
`x-workspace-id`	Oui*	UUID du workspace (*sauf routes globales)
`Content-Type`	Pour POST/PUT	`application/json`

Format des cles
Les cles API commencent par le prefixe df_. Si votre cle ne commence pas par df_, regenerez-la depuis la page Cles API.

Voir le Guide des cles API pour la gestion des cles.

Endpoints principaux

Requetes (Lecture)

Methode	Endpoint	Description
`GET`	`/api/queries/nodes`	Lister toutes les entites
`GET`	`/api/queries/nodes/:id`	Obtenir une entite par ID
`GET`	`/api/queries/edges`	Lister toutes les relations
`GET`	`/api/queries/edges/:id`	Obtenir une relation par ID

Commandes (Ecriture)

Methode	Endpoint	Description
`POST`	`/api/commands/execute`	Executer une commande

Types de commandes :

CREATE_NODE - Creer une entite
UPDATE_NODE - Modifier une entite
DELETE_NODE - Supprimer une entite
CREATE_EDGE - Creer une relation
DELETE_EDGE - Supprimer une relation
UNDO - Annuler la derniere action
REDO - Retablir la derniere action annulee

Agent IA

Methode	Endpoint	Description
`POST`	`/api/v1/agent/query`	Requete en langage naturel
`POST`	`/api/v1/agent/invoke`	Invocation avec streaming SSE
`GET`	`/api/v1/agent/tools`	Outils disponibles

Live Data

Methode	Endpoint	Description
`GET`	`/api/unified-sources`	Lister les sources de donnees
`POST`	`/api/unified-sources`	Creer une source de donnees

Workflow

Methode	Endpoint	Description
`POST`	`/api/v1/workflow/runs`	Lancer une execution
`GET`	`/api/logic/schedules`	Lister les planifications

Pagination

GET /api/queries/nodes?limit=50&offset=100

Parametre	Defaut	Max	Description
`limit`	50	100	Elements par page
`offset`	0	-	Elements a sauter

Filtrage

GET /api/queries/nodes?entityType=concept&name=Client

Tri

GET /api/queries/nodes?sort=-createdAt,name

Prefixe - pour ordre descendant
Champs multiples separes par virgule

Rate Limits

Plan	Requetes/min	Requetes/jour
Starter	60	10 000
Pro	300	100 000
Enterprise	Personnalise	Personnalise

Headers dans la reponse :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1700000000

Codes HTTP

Code	Signification
`200`	Succes
`201`	Cree
`204`	Pas de contenu (DELETE)
`400`	Requete invalide
`401`	Non authentifie
`403`	Acces interdit
`404`	Non trouve
`409`	Conflit de version
`429`	Rate limit depasse
`500`	Erreur serveur

Exemples par langage

cURL

export API_KEY="df_xxxxxxxxxxxxxxxxxxxx"
export WORKSPACE_ID="550e8400-..."
export API_URL="https://api.ontologie-growthsystemes.com"

curl "$API_URL/api/queries/nodes" \
  -H "Authorization: Bearer $API_KEY" \
  -H "x-workspace-id: $WORKSPACE_ID"

JavaScript / TypeScript

const API_URL = "https://api.ontologie-growthsystemes.com";
const API_KEY = process.env.ONTOLOGIE_API_KEY;
const WORKSPACE_ID = process.env.ONTOLOGIE_WORKSPACE_ID;

// Lire les entites
const response = await fetch(`${API_URL}/api/queries/nodes`, {
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "x-workspace-id": WORKSPACE_ID,
  },
});
const { data, meta } = await response.json();

// Creer une entite
const create = await fetch(`${API_URL}/api/commands/execute`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "x-workspace-id": WORKSPACE_ID,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "CREATE_NODE",
    payload: { name: "Client", entityType: "concept", position: { x: 100, y: 100 } },
  }),
});

Python

import os
import requests

API_URL = "https://api.ontologie-growthsystemes.com"
API_KEY = os.environ["ONTOLOGIE_API_KEY"]
WORKSPACE_ID = os.environ["ONTOLOGIE_WORKSPACE_ID"]

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "x-workspace-id": WORKSPACE_ID,
}

# Lire les entites
response = requests.get(f"{API_URL}/api/queries/nodes", headers=headers)
data = response.json()["data"]

# Creer une entite
create = requests.post(
    f"{API_URL}/api/commands/execute",
    headers={**headers, "Content-Type": "application/json"},
    json={
        "type": "CREATE_NODE",
        "payload": {"name": "Client", "entityType": "concept", "position": {"x": 100, "y": 100}},
    },
)

Configuration rapide

Creez un fichier .env pour stocker vos identifiants :

# .env
ONTOLOGIE_API_KEY=df_xxxxxxxxxxxxxxxxxxxx
ONTOLOGIE_WORKSPACE_ID=550e8400-e29b-41d4-a716-446655440000
ONTOLOGIE_API_URL=https://api.ontologie-growthsystemes.com

Ne commitez jamais ce fichier.
Ajoutez .env a votre .gitignore. Utilisez un gestionnaire de secrets en production.

Specification OpenAPI

La specification OpenAPI complete est disponible sur le Portail Client. Elle peut etre importee dans Postman, Insomnia ou tout client compatible OpenAPI 3.0.

Reference complete des endpoints

Portail Client
La reference complete des 649 endpoints (specifications OpenAPI, schemas de requete/reponse, exemples interactifs) est disponible sur le Portail Client.

Contactez votre interlocuteur commercial ou ecrivez a support@growthsystemes.com pour obtenir vos identifiants d'acces.

Besoin d'aide ?

Ecrivez-nous : Support et contact.

Envoyer un feedback sur cette page

En bref​

Prerequis techniques​

URL de base​

Authentification​

Methode 1 : Header X-API-Key (recommande)​

Methode 2 : Header Authorization: Bearer​

Headers requis​

Endpoints principaux​

Requetes (Lecture)​

Commandes (Ecriture)​

Agent IA​

Live Data​

Workflow​

Pagination​

Filtrage​

Tri​

Rate Limits​

Codes HTTP​

Exemples par langage​

cURL​

JavaScript / TypeScript​

Python​

Configuration rapide​

Specification OpenAPI​

Reference complete des endpoints​

Besoin d'aide ?​