Voici un exemple complet de flux de travail et de code Python pour construire un système permettant :

1. D’ajouter une API
2. De lister les API
3. De modifier une API (et ses endpoints)
4. De supprimer une API
5. De tester un endpoint

L’exemple ci-dessous met l’accent sur l’API Spotify pour illustrer la lecture d’une playlist et la vérification de la présence d’une musique dans une playlist. Il inclut également l’utilisation de l’API Groq (via la clé gsk_XXXXXXXXXXXXXXX) pour analyser la documentation ou la description des API que l’utilisateur souhaite ajouter.

1. Menu principal

Lors du lancement du programme, on propose à l’utilisateur le menu suivant :

1. Ajouter une API (assisté par IA)
2. Liste des API configurées
3. Modifier une API
4. Supprimer une API
5. Tester un endpoint
6. Quitter

Le code Python ci-dessous illustre un squelette d’implémentation :

python
import requests
import json
import sys

# -----------------------------------------------------------------------------
# Exemple de stockage en mémoire (vous pouvez le remplacer par une base de données ou un fichier)
apis_configurees = []

# -----------------------------------------------------------------------------
# Fonction d'appel à l'API Groq pour analyser l'entrée de l'utilisateur
def analyser_api_avec_groq(input_text, groq_api_key="gsk_XXXXXXXXXXXXXXX"):
    """
    Envoie le input_text à l'API Groq pour obtenir les informations nécessaires :
      - Type d'API (REST, GraphQL, SOAP)
      - URL de base
      - Authentification (type, nom de la clé, obligatoire ?)
      - En-têtes communs
      - Endpoints (nom, chemin, méthode, params requis/optionnels...)
      - Nom suggéré pour l’API
      - Limitation de débit
      - Score de confiance
    Retourne un dictionnaire contenant ces informations.
    
    NOTE : Le code suivant est purement illustratif. Vous devrez l'adapter à la 
    forme réelle du JSON de réponse retourné par l’API Groq.
    """
    
    # Exemple d'appel fictif à l'API Groq
    headers = {
        "Authorization": f"Bearer {groq_api_key}",
        "Content-Type": "application/json",
    }
    payload = {
        "text": input_text
    }
    # Simulation : requête fictive
    # response = requests.post("https://api.groq.io/v1/analyze", headers=headers, json=payload)
    # data = response.json()

    # Simulation d'une réponse plausible de l'API Groq
    data = {
        "api_type": "REST",
        "base_url": "https://api.spotify.com/v1",
        "auth_info": {
            "type": "Bearer",
            "key_name": "Authorization",
            "required": True
        },
        "common_headers": {
            "Content-Type": "application/json"
        },
        "endpoints": [
            {
                "name": "Get playlist tracks",
                "path": "/playlists/{playlist_id}/tracks",
                "method": "GET",
                "required_params": ["playlist_id"],
                "optional_params": [],
                "description": "Récupère les pistes d’une playlist."
            }
        ],
        "suggested_name": "Spotify",
        "rate_limit": "N/A",
        "confidence_score": 0.9
    }
    return data

# -----------------------------------------------------------------------------
# 2. Ajouter une API (assisté par IA)
def ajouter_api():
    print("=== Ajout d’une nouvelle API ===")
    
    # 2.1 Demande à l'utilisateur s'il souhaite coller la documentation
    coller_doc = input("Voulez-vous coller la documentation de l’API ? (o/n) : ")
    
    doc_api = ""
    if coller_doc.lower() == 'o':
        print("Collez la documentation ci-dessous (finissez par une ligne vide) :")
        lignes_doc = []
        while True:
            ligne = input()
            if ligne == "":
                break
            lignes_doc.append(ligne)
        doc_api = "\n".join(lignes_doc)
    
    # 2.2 Demandez l’URL ou une description en langage naturel
    url_ou_description = input("Entrez l’URL de l’API ou une description en langage naturel : ")
    
    # 2.3 Analyse via Groq
    texte_a_analyser = doc_api if doc_api else url_ou_description
    resultats_analyse = analyser_api_avec_groq(texte_a_analyser)
    
    # Extraction des informations
    confidence_score = resultats_analyse.get("confidence_score", 0)
    
    if confidence_score < 0.5:
        print("Le score de confiance de l’analyse est faible. Veuillez fournir plus d’informations.")
        # Ici on peut demander plus de détails à l’utilisateur, puis relancer l’analyse
        # ...
    
    api_type = resultats_analyse.get("api_type")
    base_url = resultats_analyse.get("base_url")
    auth_info = resultats_analyse.get("auth_info", {})
    common_headers = resultats_analyse.get("common_headers", {})
    endpoints = resultats_analyse.get("endpoints", [])
    suggested_name = resultats_analyse.get("suggested_name", "NouvelleAPI")
    
    print(f"Nom suggéré pour l’API : {suggested_name}")
    nom_api = input(f"Entrez le nom de l’API ({suggested_name}) : ")
    if not nom_api:
        nom_api = suggested_name
    
    # 2.4 Demandez la valeur de la clé API si nécessaire
    api_key_value = None
    if auth_info.get("required", False):
        api_key_value = input("Entrez la valeur de la clé API ou du token d’authentification : ")
    
    # Prépare la configuration
    nouvelle_api = {
        "name": nom_api,
        "type": api_type,
        "base_url": base_url,
        "auth_info": auth_info,
        "common_headers": common_headers,
        "api_key_value": api_key_value,
        "endpoints": endpoints
    }
    
    # 2.5 Enregistrez la configuration de l’API
    apis_configurees.append(nouvelle_api)
    print(f"L’API '{nom_api}' a bien été ajoutée avec l’URL de base : {base_url}\n")

# -----------------------------------------------------------------------------
# 3. Lister les API configurées
def lister_apis():
    print("=== Liste des API configurées ===")
    if not apis_configurees:
        print("Aucune API n'est configurée pour le moment.\n")
        return
    
    for i, api in enumerate(apis_configurees):
        print(f"{i+1}. Nom : {api['name']}")
        print(f"   URL de base : {api['base_url']}")
        print("   Endpoints :")
        for endpoint in api["endpoints"]:
            print(f"     - {endpoint['name']} ({endpoint['method']} {endpoint['path']})")
        print()
    
    print()

# -----------------------------------------------------------------------------
# 4. Modifier une API
def modifier_api():
    print("=== Modification d’une API ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 4.1 Affichez la liste des API configurées
    for i, api in enumerate(apis_configurees):
        print(f"{i+1}. {api['name']}")
    
    # 4.2 Demandez laquelle modifier (langage naturel possible, simplifié ici)
    choix = input("Quelle API souhaitez-vous modifier ? Entrez un nom ou un numéro : ")
    api_choisie = None
    
    # On essaie d'abord de voir si l'utilisateur a tapé un numéro
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_choisie = apis_configurees[index]
    except ValueError:
        # Sinon on essaie de faire correspondre par nom
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_choisie = api
                break
    
    if not api_choisie:
        print("API introuvable.\n")
        return
    
    print(f"API sélectionnée : {api_choisie['name']}")
    # 4.3 Demandez ce qu’il faut modifier
    print("Que voulez-vous modifier ? (URL de base, clé API, ajouter un endpoint, modifier un endpoint, supprimer un endpoint, etc.)")
    modification = input("> ")
    
    # Exemple (logique simplifiée) :
    if "url" in modification.lower():
        nouvelle_url = input("Entrez la nouvelle URL de base : ")
        api_choisie["base_url"] = nouvelle_url
        print("URL de base modifiée avec succès.\n")
    
    if "clé" in modification.lower() or "key" in modification.lower():
        nouvelle_cle = input("Entrez la nouvelle clé API : ")
        api_choisie["api_key_value"] = nouvelle_cle
        print("Clé API modifiée avec succès.\n")
    
    if "ajouter un endpoint" in modification.lower():
        print("=== Ajout d'un endpoint ===")
        nom_endpoint = input("Nom du nouvel endpoint : ")
        path_endpoint = input("Chemin (ex: /playlists/{playlist_id}/tracks) : ")
        methode = input("Méthode HTTP (GET, POST, etc.) : ")
        params_requis = input("Paramètres requis (séparés par des virgules) : ").split(",")
        params_op = input("Paramètres optionnels (séparés par des virgules) : ").split(",")
        
        nouveau_endpoint = {
            "name": nom_endpoint,
            "path": path_endpoint,
            "method": methode.upper(),
            "required_params": [p.strip() for p in params_requis if p.strip()],
            "optional_params": [p.strip() for p in params_op if p.strip()],
            "description": ""
        }
        api_choisie["endpoints"].append(nouveau_endpoint)
        print(f"Endpoint '{nom_endpoint}' ajouté.\n")
    
    if "modifier un endpoint" in modification.lower():
        print("=== Modification d'un endpoint existant ===")
        for i, ep in enumerate(api_choisie["endpoints"]):
            print(f"{i+1}. {ep['name']} ({ep['method']} {ep['path']})")
        choix_ep = input("Quel endpoint souhaitez-vous modifier ? (numéro ou nom) : ")
        
        endpoint_choisi = None
        try:
            ep_index = int(choix_ep) - 1
            if 0 <= ep_index < len(api_choisie["endpoints"]):
                endpoint_choisi = api_choisie["endpoints"][ep_index]
        except ValueError:
            for ep in api_choisie["endpoints"]:
                if ep["name"].lower() == choix_ep.lower():
                    endpoint_choisi = ep
                    break
        
        if not endpoint_choisi:
            print("Endpoint introuvable.")
            return
        
        print(f"Endpoint sélectionné : {endpoint_choisi['name']}")
        action_modif = input("Que voulez-vous modifier ? (ex: ajouter un paramètre, changer la méthode, etc.) : ")
        
        if "ajouter un paramètre" in action_modif.lower():
            nom_param = input("Nom du paramètre : ")
            type_param = input("Paramètre requis ou optionnel ? (r/o) : ")
            if type_param.lower() == "r":
                endpoint_choisi["required_params"].append(nom_param)
                print(f"Le paramètre requis '{nom_param}' a été ajouté.")
            else:
                endpoint_choisi["optional_params"].append(nom_param)
                print(f"Le paramètre optionnel '{nom_param}' a été ajouté.")
    
    if "supprimer un endpoint" in modification.lower():
        print("=== Suppression d'un endpoint ===")
        for i, ep in enumerate(api_choisie["endpoints"]):
            print(f"{i+1}. {ep['name']} ({ep['method']} {ep['path']})")
        choix_ep = input("Quel endpoint souhaitez-vous supprimer ? (numéro ou nom) : ")
        
        ep_a_supprimer = None
        try:
            ep_index = int(choix_ep) - 1
            if 0 <= ep_index < len(api_choisie["endpoints"]):
                ep_a_supprimer = api_choisie["endpoints"][ep_index]
        except ValueError:
            for ep in api_choisie["endpoints"]:
                if ep["name"].lower() == choix_ep.lower():
                    ep_a_supprimer = ep
                    break
        
        if ep_a_supprimer:
            api_choisie["endpoints"].remove(ep_a_supprimer)
            print(f"L’endpoint '{ep_a_supprimer['name']}' a été supprimé.")
        else:
            print("Endpoint introuvable.")
    
    print("Modification(s) terminée(s).\n")

# -----------------------------------------------------------------------------
# 5. Supprimer une API
def supprimer_api():
    print("=== Suppression d’une API ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 5.1 Liste des API
    for i, api in enumerate(apis_configurees):
        print(f"{i+1}. {api['name']}")
    
    # 5.2 Demandez laquelle supprimer (en langage naturel ou numéro)
    choix = input("Quelle API souhaitez-vous supprimer ? (nom ou numéro) : ")
    
    api_a_supprimer = None
    
    # On essaie d'abord de voir si l'utilisateur a tapé un numéro
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_a_supprimer = apis_configurees[index]
    except ValueError:
        # Sinon on essaie de faire correspondre par nom
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_a_supprimer = api
                break
    
    if not api_a_supprimer:
        print("API introuvable.\n")
        return
    
    # 5.3 Demandez confirmation
    confirm = input(f"Êtes-vous sûr de vouloir supprimer l’API {api_a_supprimer['name']} ? (o/n) : ")
    if confirm.lower() == 'o':
        apis_configurees.remove(api_a_supprimer)
        print(f"L’API {api_a_supprimer['name']} a été supprimée.\n")
    else:
        print("Opération annulée.\n")

# -----------------------------------------------------------------------------
# 6. Tester un endpoint (Exemple avec Spotify)
def tester_endpoint():
    print("=== Tester un endpoint ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 6.1 Sélection de l’API
    for i, api in enumerate(apis_configurees):
        print(f"{i+1}. {api['name']}")
    choix = input("Sur quelle API souhaitez-vous tester un endpoint ? (nom ou numéro) : ")
    
    api_choisie = None
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_choisie = apis_configurees[index]
    except ValueError:
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_choisie = api
                break
    
    if not api_choisie:
        print("API introuvable.\n")
        return
    
    # 6.2 Sélection de l’endpoint
    if not api_choisie["endpoints"]:
        print(f"L’API {api_choisie['name']} n’a aucun endpoint configuré.\n")
        return
    
    print(f"Endpoints disponibles pour {api_choisie['name']} :")
    for i, ep in enumerate(api_choisie["endpoints"]):
        print(f"{i+1}. {ep['name']} ({ep['method']} {ep['path']})")
    choix_ep = input("Quel endpoint souhaitez-vous tester ? (numéro ou nom) : ")
    
    endpoint_choisi = None
    try:
        ep_index = int(choix_ep) - 1
        if 0 <= ep_index < len(api_choisie["endpoints"]):
            endpoint_choisi = api_choisie["endpoints"][ep_index]
    except ValueError:
        for ep in api_choisie["endpoints"]:
            if ep["name"].lower() == choix_ep.lower():
                endpoint_choisi = ep
                break
    
    if not endpoint_choisi:
        print("Endpoint introuvable.")
        return
    
    # Exemple concret pour Spotify :
    #  - Lire une playlist : besoin d’un playlist_id
    #  - Vérifier si une musique est dans une playlist : besoin d’un playlist_id et d’un track_id
    
    # 6.3 Récupération des paramètres
    required_params = {}
    for rp in endpoint_choisi.get("required_params", []):
        required_params[rp] = input(f"Entrez la valeur pour '{rp}' : ")
    
    optional_params = {}
    for op in endpoint_choisi.get("optional_params", []):
        val = input(f"Entrez la valeur (ou laissez vide) pour le paramètre optionnel '{op}' : ")
        if val:
            optional_params[op] = val

    # Construction de l’URL
    base_url = api_choisie["base_url"]
    path = endpoint_choisi["path"]
    # Remplace, si besoin, les variables {playlist_id} dans le chemin
    for rp_key, rp_value in required_params.items():
        path = path.replace(f"{{{rp_key}}}", rp_value)
    
    url = base_url + path
    
    # 6.4 Préparez la requête
    headers = dict(api_choisie["common_headers"])
    if api_choisie["auth_info"].get("required", False) and api_choisie.get("api_key_value"):
        if api_choisie["auth_info"]["type"].lower() == "bearer":
            headers["Authorization"] = f"Bearer {api_choisie['api_key_value']}"
        else:
            # Autres types d’authentification
            headers[api_choisie["auth_info"]["key_name"]] = api_choisie["api_key_value"]
    
    # Exemples de gestion des query params (optionnels)
    params = {}
    for op_key, op_value in optional_params.items():
        params[op_key] = op_value
    
    method = endpoint_choisi["method"].upper()
    print(f"Lancement du test de l'endpoint : {method} {url}")

    # 6.5 Exécution de la requête
    response = None
    try:
        if method == "GET":
            response = requests.get(url, headers=headers, params=params)
        elif method == "POST":
            # Ex: on peut mettre les params dans le body JSON
            response = requests.post(url, headers=headers, json=params)
        else:
            print(f"Méthode {method} non gérée dans cet exemple.")
            return
        
        if response is not None:
            print(f"Statut: {response.status_code}")
            print("Réponse:")
            try:
                print(json.dumps(response.json(), indent=2))
            except:
                print(response.text)
    except Exception as e:
        print(f"Erreur lors de l’appel à l’endpoint : {e}")

# -----------------------------------------------------------------------------
# Fonction principale
def main():
    while True:
        print("=== Menu Principal ===")
        print("1. Ajouter une API (assisté par IA)")
        print("2. Liste des API configurées")
        print("3. Modifier une API")
        print("4. Supprimer une API")
        print("5. Tester un endpoint")
        print("6. Quitter")
        
        choix = input("Choisissez une option : ")
        if choix == '1':
            ajouter_api()
        elif choix == '2':
            lister_apis()
        elif choix == '3':
            modifier_api()
        elif choix == '4':
            supprimer_api()
        elif choix == '5':
            tester_endpoint()
        elif choix == '6':
            print("Au revoir !")
            sys.exit(0)
        else:
            print("Choix invalide.\n")


if __name__ == "__main__":
    main()

Explication pas à pas

1. Menu principal :
   L’utilisateur est accueilli par un menu principal qui lui permet d’ajouter une API, de voir la liste des APIs configurées, de modifier une API, de la supprimer, de tester un endpoint ou de quitter.

2. Ajouter une API :

   • On propose à l’utilisateur de coller la documentation de l’API ou de fournir simplement une URL ou une description en langage naturel.
   • Les informations fournies (documentation ou description) sont analysées par l’API Groq (clé gsk_XXXXXXXXXXXXXXX), qui renvoie un score de confiance et diverses informations (type d’API, URL de base, endpoints, etc.).
   • Si le score de confiance est trop faible, on invite l’utilisateur à compléter les informations.
   • On stocke ensuite tous ces détails dans une configuration interne (ici, simplement en mémoire dans la liste apis_configurees).

3. Lister les API configurées :

   • On affiche le nom de chaque API, son URL de base et la liste de ses endpoints.

4. Modifier une API :

   • On affiche la liste des API existantes.
   • L’utilisateur peut choisir l’API à modifier en langage naturel (nom) ou via son index.
   • Il peut ensuite préciser (en langage naturel) s’il veut modifier l’URL de base, la clé d’authentification, ajouter/modifier/supprimer un endpoint, etc.
   • Par exemple, pour ajouter un paramètre à un endpoint /playlists/{playlist_id}/tracks, on demande simplement le nom du paramètre, puis on l’ajoute soit à la liste des paramètres obligatoires, soit à la liste des paramètres optionnels.

5. Supprimer une API :

   • On liste les API, puis l’utilisateur peut (par nom ou index) choisir celle qu’il souhaite supprimer.
   • On demande une confirmation avant la suppression.

6. Tester un endpoint (exemple Spotify) :

   • L’utilisateur choisit d’abord l’API, puis l’endpoint qu’il souhaite tester.
   • On lui demande de remplir les paramètres requis et optionnels (par exemple, playlist_id, market, track_id, etc.).
   • Le code se charge de construire l’URL finale, d’ajouter les bons en-têtes (y compris l’authentification si nécessaire) et d’exécuter la requête via la librairie requests.
   • Enfin, on affiche le statut et la réponse pour permettre à l’utilisateur de voir si la requête a abouti.
   • Dans l’exemple concret :
     • Si l’utilisateur souhaite lire une playlist, il fournit juste l’ID de la playlist.
     • S’il souhaite vérifier si une musique est dans une playlist, il fournit l’ID de la playlist et l’ID de la musique.

Ce système, avec son interface en ligne de commande, vous permet de gérer de façon intuitive le cycle de vie (ajout, configuration, modification, suppression) de vos intégrations d’API, tout en testant rapidement les endpoints configurés. Pour des besoins plus avancés, vous pourrez étendre cette logique à l’aide d’une base de données, d’une interface graphique ou d’autres composants pour mieux organiser et partager vos configurations d’API.

Voici comment vous pouvez adapter votre système pour intégrer l’API Groq de Chat Completion dans la phase d’analyse de l’API (étape 2) :

1. Présentation de l’intégration de Groq

La documentation Groq indique comment faire des requêtes de chat completion. Pour rappel, vous voulez extraire automatiquement les informations suivantes à partir d’un texte (URL, description, documentation API) :

• Type d'API (REST, GraphQL, SOAP)
• URL de base
• Informations d'authentification
• En-têtes communs
• Endpoints détectés (chemin, méthode, paramètres, etc.)
• Nom suggéré pour l'API
• Limitation de débit
• Score de confiance de l'analyse

La logique consistera donc à :

1. Construire un prompt (messages) pour Groq qui décrit la tâche :

   • Rôle system : « Tu es un assistant d'analyse d'API qui doit renvoyer un JSON décrivant les informations de l’API. »
   • Rôle user : c’est le texte fourni par l’utilisateur (URL, doc, description).

2. Envoyer la requête à Groq en utilisant le client Python (pip install groq).

3. Récupérer la réponse en JSON (ou en texte brut si vous ne voulez pas activer le mode JSON bêta).

4. Extraire les champs (type d’API, base_url, endpoints, etc.) depuis le JSON de Groq.

5. Les renseigner dans la configuration de votre API.

2. Exemple de fonction analyser_api_avec_groq modifiée

Voici un exemple simplifié d’implémentation, où l’on utilise une chat completion de Groq pour extraire les informations d’une API. Dans cet exemple, nous allons :

• Créer un prompt minimal qui demande à Groq de détecter les champs d’API.
• Utiliser la librairie groq pour envoyer la requête.
• Parcourir la réponse pour en extraire les informations.

python
from groq import Groq
import json

def analyser_api_avec_groq(input_text, groq_api_key="gsk_XXXXXXXXXXXXXXX"):
    """
    Envoie 'input_text' à l’API Groq via un chat completion,
    et récupère un JSON décrivant les informations d'API.
    """
    # Instanciation du client Groq
    client = Groq(api_key=groq_api_key)

    # Préparez les messages pour la conversation
    # (Rôle "system" : donnez le format de retour désiré,
    #  Rôle "user" : mettez le 'input_text' à analyser)
    messages = [
        {
            "role": "system",
            "content": (
                "Tu es un assistant d'analyse d'API. "
                "Retourne un JSON de la forme :\n"
                "{\n"
                "  \"api_type\": \"REST | GraphQL | SOAP\",\n"
                "  \"base_url\": \"string\",\n"
                "  \"auth_info\": {\n"
                "      \"type\": \"string (Bearer, Basic, etc.)\",\n"
                "      \"key_name\": \"string\",\n"
                "      \"required\": \"bool\"\n"
                "  },\n"
                "  \"common_headers\": {\n"
                "      \"Header-Name\": \"Header-Value\"\n"
                "  },\n"
                "  \"endpoints\": [\n"
                "      {\n"
                "          \"name\": \"string\",\n"
                "          \"path\": \"string\",\n"
                "          \"method\": \"GET | POST | ...\",\n"
                "          \"required_params\": [\"param1\", \"param2\"],\n"
                "          \"optional_params\": [\"param1\", \"param2\"],\n"
                "          \"description\": \"string\"\n"
                "      }\n"
                "  ],\n"
                "  \"suggested_name\": \"string\",\n"
                "  \"rate_limit\": \"string\",\n"
                "  \"confidence_score\": \"number between 0 and 1\"\n"
                "}\n"
                "Analyse le texte ci-après et remplis au maximum ces champs."
            )
        },
        {
            "role": "user",
            "content": input_text
        }
    ]

    try:
        # Appel à l'API Groq
        chat_completion = client.chat.completions.create(
            messages=messages,
            model="llama-3.3-70b-versatile",
            temperature=0.0,
            max_completion_tokens=1024,
            top_p=1,
            # Pas de streaming pour simplifier
            stream=False,
            # Optionnel : on peut forcer le format JSON si on souhaite
            # "response_format": {"type": "json_object"},
        )
        
        # Récupération du contenu textuel
        content = chat_completion.choices[0].message.content
        
        # Tente de parser le résultat en JSON
        data = json.loads(content)

        # Idéalement, on vérifie la présence des clés attendues.
        return data

    except Exception as e:
        print(f"Erreur lors de l'analyse Groq : {e}")
        # Retour d’un squelette par défaut en cas de souci
        return {
            "api_type": None,
            "base_url": None,
            "auth_info": {},
            "common_headers": {},
            "endpoints": [],
            "suggested_name": "API_Inconnue",
            "rate_limit": None,
            "confidence_score": 0.0
        }

Ce qui change par rapport à l’exemple précédent

1. Nous importons et utilisons la classe Groq du SDK Python pour envoyer une requête Chat Completion à Groq.
2. Nous formons le prompt (liste messages) avec un rôle system qui indique clairement le format JSON attendu, et un rôle user contenant le texte de l’utilisateur.
3. Nous appelons client.chat.completions.create(...) et récupérons la réponse.
4. Nous convertissons la réponse en JSON via json.loads(...).
5. Nous renvoyons ce JSON, que l’on intègre ensuite dans notre flux normal (détection du confidence_score, etc.).

3. Intégration dans le système complet

Le reste du code (menu principal, ajout, modification, suppression, test d’un endpoint) ne change presque pas. Il suffit de remplacer la fonction d’analyse fictive par la nouvelle fonction analyser_api_avec_groq ci-dessus.

Par exemple, dans la partie « 2. Ajouter une API (assisté par IA) », vous appelez :

python
resultats_analyse = analyser_api_avec_groq(texte_a_analyser)

… au lieu de la fonction précédente. Le reste de la logique (extraction de api_type, base_url, etc.) est le même.

4. Récapitulatif des étapes pour l’utilisateur

Voici comment le flux se déroulera avec la nouvelle intégration Groq :

1. Menu Principal : L’utilisateur choisit « Ajouter une API (assisté par IA) ».
2. Coller la doc ou fournir une URL / description.
3. Appel Groq :
   • Votre code envoie un prompt à l’API Groq contenant (en system) le schéma JSON désiré, puis (en user) le texte fourni.
   • Groq renvoie un JSON structuré contenant (idéalement) les infos d’API détectées.
4. Score de confiance :
   • Si confidence_score < 0.5, demandez des précisions à l’utilisateur.
5. Enregistrement :
   • Enregistrez ces infos dans la configuration interne (apis_configurees).
6. Liste, Modification et Suppression :
   • Inchangés : on continue à proposer la liste des API, le choix de modifications en langage naturel (URL, clé, endpoints).
7. Test d’un endpoint :
   • Pareil : on demande les paramètres, on construit la requête requests.get() ou requests.post(), etc., on affiche la réponse.

5. Exemple d’utilisation concrète avec Spotify

Prenons l’exemple d’une documentation (ou description) assez concise pour l’API Spotify, comme :

« Spotify a une API REST pour gérer les playlists. L’URL de base est https://api.spotify.com/v1. Il faut un Bearer token dans l’en-tête Authorization. Un endpoint GET /playlists/{playlist_id}/tracks permet de lister les pistes. »

Le système :

1. L’utilisateur colle ce texte.
2. Notre fonction analyser_api_avec_groq envoie le prompt à Groq, qui renvoie un JSON avec :
   • api_type: "REST"
   • base_url: "https://api.spotify.com/v1"
   • auth_info: { "type": "Bearer", "key_name": "Authorization", "required": True }
   • etc.
3. Nous détectons un confidence_score. Disons qu’il vaut 0.85.
4. Nous invitons l’utilisateur à saisir la clé token Spotify.
5. Nous stockons la config.

Ensuite, l’utilisateur peut :

• Lister les API (voit « Spotify »).
• Modifier un endpoint par langage naturel (« Je veux ajouter un paramètre market de type optionnel »).
• Supprimer l’API (« supprime l’API Spotify »).
• Tester un endpoint en saisissant playlist_id et, si souhaité, market.

Conclusion

En reprenant le squelette de code fourni et en remplaçant la fonction d’analyse par l’exemple ci-dessus qui utilise Groq, vous rendez votre système entièrement opérationnel :

1. Récupération du texte utilisateur.
2. Analyse via Groq (Chat Completion).
3. Extraction des champs dans le JSON de réponse.
4. Configuration de l’API dans votre système.
5. Utilisation (ajout, modification, suppression, test) comme détaillé dans votre code initial.

Vous profitez ainsi de la puissance du LLM de Groq pour structurer automatiquement la configuration d’API sans avoir à écrire de règles complexes.

Voici un exemple de code Python complet qui illustre :

1. Un menu principal en ligne de commande.
2. L’ajout d’une API par analyse intelligente de la documentation (ou description) via l’API Groq (clé gsk_XXXXXXXXXXXXXXX).
3. La liste des APIs configurées.
4. La modification d’une API (URL, clé, endpoints, etc.) en langage naturel.
5. La suppression d’une API en langage naturel.
6. Le test d’un endpoint, avec un exemple concret d’utilisation de l’API Spotify (lecture de playlist, vérification de la présence d’une musique).

Ce code est pensé pour être facilement adapté et étendu selon vos besoins. Suivez les commentaires pour comprendre chaque partie.

1. Installer la librairie Groq

Avant de tester ce script, installez la librairie Groq :

bash
pip install groq

2. Code Complet

python
import sys
import json
import requests

# IMPORTANT : importez le SDK Groq
from groq import Groq

# -----------------------------------------------------------------------------
# Stockage en mémoire des APIs (vous pouvez remplacer par un fichier ou une base de données)
apis_configurees = []

# -----------------------------------------------------------------------------
# Fonction d'appel à l'API Groq pour analyser l'entrée de l'utilisateur
def analyser_api_avec_groq(input_text, groq_api_key="gsk_XXXXXXXXXXXXXXX"):
    """
    Envoie 'input_text' à l’API Groq via un chat completion,
    pour en extraire un JSON décrivant les informations d'API.
    Le JSON renvoyé doit contenir au moins :
      - api_type          (REST, GraphQL, SOAP)
      - base_url
      - auth_info         (type, key_name, required)
      - common_headers
      - endpoints         (liste d’endpoints)
      - suggested_name
      - rate_limit
      - confidence_score  (nombre entre 0 et 1)
    """
    # Initialisation du client Groq avec la clé fournie
    client = Groq(api_key=groq_api_key)

    # Préparez les messages pour la conversation
    # Rôle "system" : instruction à Groq sur le format JSON désiré
    # Rôle "user" : le texte de l’utilisateur (doc API, URL, description)
    messages = [
        {
            "role": "system",
            "content": (
                "Tu es un assistant d'analyse d'API. "
                "Retourne un JSON de la forme :\n"
                "{\n"
                "  \"api_type\": \"REST | GraphQL | SOAP\",\n"
                "  \"base_url\": \"string\",\n"
                "  \"auth_info\": {\n"
                "      \"type\": \"string (Bearer, Basic, etc.)\",\n"
                "      \"key_name\": \"string\",\n"
                "      \"required\": true/false\n"
                "  },\n"
                "  \"common_headers\": {\n"
                "      \"Header-Name\": \"Header-Value\"\n"
                "  },\n"
                "  \"endpoints\": [\n"
                "      {\n"
                "          \"name\": \"string\",\n"
                "          \"path\": \"string\",\n"
                "          \"method\": \"GET | POST | ...\",\n"
                "          \"required_params\": [\"param1\", \"param2\"],\n"
                "          \"optional_params\": [\"param1\", \"param2\"],\n"
                "          \"description\": \"string\"\n"
                "      }\n"
                "  ],\n"
                "  \"suggested_name\": \"string\",\n"
                "  \"rate_limit\": \"string\",\n"
                "  \"confidence_score\": 0.x\n"
                "}\n"
                "Analyse le texte ci-après et complète ces champs."
            )
        },
        {
            "role": "user",
            "content": input_text
        }
    ]

    try:
        # Appel Chat Completion à l'API Groq
        chat_completion = client.chat.completions.create(
            messages=messages,
            model="llama-3.3-70b-versatile",
            temperature=0.0,            # On veut une réponse la plus déterministe possible
            max_completion_tokens=1024,
            top_p=1,
            stream=False,
            # Vous pouvez activer le mode JSON bêta :
            # response_format={"type": "json_object"},
        )
        
        # Récupère le texte de la réponse
        content = chat_completion.choices[0].message.content
        
        # Tente de parser en JSON
        data = json.loads(content)

        return data

    except Exception as e:
        print(f"Erreur lors de l'analyse Groq : {e}")
        # En cas d'erreur, on renvoie un squelette vide
        return {
            "api_type": None,
            "base_url": None,
            "auth_info": {
                "type": None,
                "key_name": None,
                "required": False
            },
            "common_headers": {},
            "endpoints": [],
            "suggested_name": "API_Inconnue",
            "rate_limit": None,
            "confidence_score": 0.0
        }

# -----------------------------------------------------------------------------
# 2. Ajout d'une API (assisté par IA)
def ajouter_api():
    print("=== Ajout d’une nouvelle API ===")
    
    # 2.1 Demande à l'utilisateur s'il souhaite coller la documentation
    coller_doc = input("Voulez-vous coller la documentation de l’API ? (o/n) : ")
    
    doc_api = ""
    if coller_doc.lower() == 'o':
        print("Collez la documentation ci-dessous (validez par une ligne vide) :")
        lignes_doc = []
        while True:
            ligne = input()
            if ligne == "":
                break
            lignes_doc.append(ligne)
        doc_api = "\n".join(lignes_doc)
    
    # 2.2 Demandez l’URL ou une description en langage naturel
    url_ou_description = input("Entrez l’URL de l’API ou une description en langage naturel : ")
    
    # Prépare le texte à analyser
    texte_a_analyser = doc_api if doc_api else url_ou_description
    
    # 2.3 Analyse via Groq
    resultats_analyse = analyser_api_avec_groq(texte_a_analyser, groq_api_key="gsk_XXXXXXXXXXXXXXX")
    
    confidence_score = resultats_analyse.get("confidence_score", 0)
    
    # 2.4 Si le score de confiance est faible, on redemande plus d'infos
    if confidence_score < 0.5:
        print("Le score de confiance de l’analyse est faible. Veuillez fournir plus d’informations.")
        # Optionnel : on pourrait réitérer la demande à l’utilisateur
        # ...
    
    # Récupération des champs
    api_type = resultats_analyse.get("api_type")
    base_url = resultats_analyse.get("base_url")
    auth_info = resultats_analyse.get("auth_info", {})
    common_headers = resultats_analyse.get("common_headers", {})
    endpoints = resultats_analyse.get("endpoints", [])
    suggested_name = resultats_analyse.get("suggested_name", "NouvelleAPI")
    rate_limit = resultats_analyse.get("rate_limit")

    print(f"Nom suggéré pour l’API : {suggested_name}")
    nom_api = input(f"Entrez le nom de l’API ({suggested_name}) : ")
    if not nom_api:
        nom_api = suggested_name
    
    # Authentification
    api_key_value = None
    if auth_info.get("required", False):
        api_key_value = input("Entrez la valeur de la clé API ou du token d’authentification : ")
    
    # Construction de la configuration de la nouvelle API
    nouvelle_api = {
        "name": nom_api,
        "type": api_type,
        "base_url": base_url,
        "auth_info": auth_info,
        "api_key_value": api_key_value,
        "common_headers": common_headers,
        "endpoints": endpoints,
        "rate_limit": rate_limit
    }
    
    # 2.5 Enregistrement
    apis_configurees.append(nouvelle_api)
    print(f"L’API '{nom_api}' a bien été ajoutée avec l’URL de base : {base_url}\n")

# -----------------------------------------------------------------------------
# 3. Lister les API configurées
def lister_apis():
    print("=== Liste des API configurées ===")
    if not apis_configurees:
        print("Aucune API n’est configurée pour le moment.\n")
        return
    
    for i, api in enumerate(apis_configurees):
        print(f"{i+1}. Nom : {api['name']}")
        print(f"   URL de base : {api['base_url']}")
        print(f"   Type : {api.get('type')}")
        if api.get("rate_limit"):
            print(f"   Limitation de débit : {api['rate_limit']}")
        print("   Endpoints :")
        for endpoint in api["endpoints"]:
            print(f"     - {endpoint['name']} ({endpoint['method']} {endpoint['path']})")
        print()
    print()

# -----------------------------------------------------------------------------
# 4. Modifier une API
def modifier_api():
    print("=== Modification d’une API ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 4.1 Affichez la liste des API
    for i, api in enumerate(apis_configurees):
        print(f"{i+1}. {api['name']}")
    
    # 4.2 Demandez laquelle modifier (nom ou numéro)
    choix = input("Quelle API souhaitez-vous modifier ? Entrez un nom ou un numéro : ")
    api_choisie = None
    
    # Tente la conversion en entier
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_choisie = apis_configurees[index]
    except ValueError:
        # Sinon on cherche par nom
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_choisie = api
                break
    
    if not api_choisie:
        print("API introuvable.\n")
        return
    
    print(f"API sélectionnée : {api_choisie['name']}")
    print("Que voulez-vous modifier ? (ex: 'changer l'URL de base', 'mettre à jour la clé API', 'ajouter un endpoint', 'modifier un endpoint', 'supprimer un endpoint')")
    modification = input("> ")
    
    # 4.3 Logique simplifiée d’interprétation du texte
    modification_lower = modification.lower()
    
    if "url" in modification_lower:
        nouvelle_url = input("Entrez la nouvelle URL de base : ")
        api_choisie["base_url"] = nouvelle_url
        print("URL de base modifiée avec succès.\n")
    
    if "clé" in modification_lower or "key" in modification_lower:
        nouvelle_cle = input("Entrez la nouvelle clé API : ")
        api_choisie["api_key_value"] = nouvelle_cle
        print("Clé API modifiée avec succès.\n")
    
    if "ajouter un endpoint" in modification_lower:
        print("=== Ajout d'un endpoint ===")
        nom_endpoint = input("Nom du nouvel endpoint : ")
        path_endpoint = input("Chemin (ex: /playlists/{playlist_id}/tracks) : ")
        methode = input("Méthode HTTP (GET, POST, etc.) : ")
        params_requis = input("Paramètres requis (séparés par des virgules) : ").split(",")
        params_op = input("Paramètres optionnels (séparés par des virgules) : ").split(",")
        
        nouveau_endpoint = {
            "name": nom_endpoint,
            "path": path_endpoint,
            "method": methode.upper(),
            "required_params": [p.strip() for p in params_requis if p.strip()],
            "optional_params": [p.strip() for p in params_op if p.strip()],
            "description": ""
        }
        api_choisie["endpoints"].append(nouveau_endpoint)
        print(f"Endpoint '{nom_endpoint}' ajouté.\n")
    
    if "modifier un endpoint" in modification_lower:
        print("=== Modification d'un endpoint existant ===")
        for i, ep in enumerate(api_choisie["endpoints"]):
            print(f"{i+1}. {ep['name']} ({ep['method']} {ep['path']})")
        choix_ep = input("Quel endpoint souhaitez-vous modifier ? (numéro ou nom) : ")
        
        endpoint_choisi = None
        try:
            ep_index = int(choix_ep) - 1
            if 0 <= ep_index < len(api_choisie["endpoints"]):
                endpoint_choisi = api_choisie["endpoints"][ep_index]
        except ValueError:
            for ep in api_choisie["endpoints"]:
                if ep["name"].lower() == choix_ep.lower():
                    endpoint_choisi = ep
                    break
        
        if not endpoint_choisi:
            print("Endpoint introuvable.")
            return
        
        print(f"Endpoint sélectionné : {endpoint_choisi['name']}")
        action_modif = input("Que voulez-vous modifier ? (ex: 'ajouter un paramètre', 'changer la méthode', etc.) : ")
        
        if "ajouter un paramètre" in action_modif.lower():
            nom_param = input("Nom du paramètre : ")
            type_param = input("Paramètre requis ou optionnel ? (r/o) : ")
            if type_param.lower() == "r":
                endpoint_choisi["required_params"].append(nom_param)
                print(f"Le paramètre requis '{nom_param}' a été ajouté.")
            else:
                endpoint_choisi["optional_params"].append(nom_param)
                print(f"Le paramètre optionnel '{nom_param}' a été ajouté.")
    
    if "supprimer un endpoint" in modification_lower:
        print("=== Suppression d'un endpoint ===")
        for i, ep in enumerate(api_choisie["endpoints"]):
            print(f"{i+1}. {ep['name']} ({ep['method']} {ep['path']})")
        choix_ep = input("Quel endpoint souhaitez-vous supprimer ? (numéro ou nom) : ")
        
        ep_a_supprimer = None
        try:
            ep_index = int(choix_ep) - 1
            if 0 <= ep_index < len(api_choisie["endpoints"]):
                ep_a_supprimer = api_choisie["endpoints"][ep_index]
        except ValueError:
            for ep in api_choisie["endpoints"]:
                if ep["name"].lower() == choix_ep.lower():
                    ep_a_supprimer = ep
                    break
        
        if ep_a_supprimer:
            api_choisie["endpoints"].remove(ep_a_supprimer)
            print(f"L’endpoint '{ep_a_supprimer['name']}' a été supprimé.")
        else:
            print("Endpoint introuvable.")
    
    print("Modification(s) terminée(s).\n")

# -----------------------------------------------------------------------------
# 5. Supprimer une API
def supprimer_api():
    print("=== Suppression d’une API ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 5.1 Liste des API
    for i, api in enumerate(apis_configurees):
        print(f"{i+1}. {api['name']}")
    
    # 5.2 Demandez laquelle supprimer (nom ou numéro)
    choix = input("Quelle API souhaitez-vous supprimer ? (nom ou numéro) : ")
    
    api_a_supprimer = None
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_a_supprimer = apis_configurees[index]
    except ValueError:
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_a_supprimer = api
                break
    
    if not api_a_supprimer:
        print("API introuvable.\n")
        return
    
    # 5.3 Confirmation
    confirm = input(f"Êtes-vous sûr de vouloir supprimer l’API {api_a_supprimer['name']} ? (o/n) : ")
    if confirm.lower() == 'o':
        apis_configurees.remove(api_a_supprimer)
        print(f"L’API {api_a_supprimer['name']} a été supprimée.\n")
    else:
        print("Opération annulée.\n")

# -----------------------------------------------------------------------------
# 6. Tester un Endpoint (Exemple avec Spotify)
def tester_endpoint():
    print("=== Tester un endpoint ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 6.1 Sélection de l’API
    for i, api in enumerate(apis_configurees):
        print(f"{i+1}. {api['name']}")
    choix = input("Sur quelle API souhaitez-vous tester un endpoint ? (nom ou numéro) : ")
    
    api_choisie = None
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_choisie = apis_configurees[index]
    except ValueError:
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_choisie = api
                break
    
    if not api_choisie:
        print("API introuvable.\n")
        return
    
    # 6.2 Sélection de l’endpoint
    if not api_choisie["endpoints"]:
        print(f"L’API {api_choisie['name']} n’a aucun endpoint configuré.\n")
        return
    
    print(f"Endpoints disponibles pour {api_choisie['name']} :")
    for i, ep in enumerate(api_choisie["endpoints"]):
        print(f"{i+1}. {ep['name']} ({ep['method']} {ep['path']})")
    choix_ep = input("Quel endpoint souhaitez-vous tester ? (numéro ou nom) : ")
    
    endpoint_choisi = None
    try:
        ep_index = int(choix_ep) - 1
        if 0 <= ep_index < len(api_choisie["endpoints"]):
            endpoint_choisi = api_choisie["endpoints"][ep_index]
    except ValueError:
        for ep in api_choisie["endpoints"]:
            if ep["name"].lower() == choix_ep.lower():
                endpoint_choisi = ep
                break
    
    if not endpoint_choisi:
        print("Endpoint introuvable.")
        return
    
    # Exemple concret pour Spotify :
    #  - Lire une playlist : param requis => playlist_id
    #  - Vérifier si une musique est dans une playlist : param requis => playlist_id, track_id (ou music_id)
    
    # 6.3 Récupération des paramètres (required et optional)
    required_params = {}
    for rp in endpoint_choisi.get("required_params", []):
        required_params[rp] = input(f"Entrez la valeur pour '{rp}' : ")
    
    optional_params = {}
    for op in endpoint_choisi.get("optional_params", []):
        val = input(f"Entrez la valeur (ou laissez vide) pour le paramètre optionnel '{op}' : ")
        if val:
            optional_params[op] = val
    
    # 6.4 Construction de l’URL
    base_url = api_choisie["base_url"]
    path = endpoint_choisi["path"]
    # Remplace les variables {param} dans le path
    for rp_key, rp_value in required_params.items():
        path = path.replace(f"{{{rp_key}}}", rp_value)
    url = base_url + path
    
    # Prépare les en-têtes
    headers = dict(api_choisie["common_headers"])
    auth_info = api_choisie.get("auth_info", {})
    if auth_info.get("required") and api_choisie.get("api_key_value"):
        if auth_info["type"].lower() == "bearer":
            headers[auth_info["key_name"]] = f"Bearer {api_choisie['api_key_value']}"
        else:
            # Autres types (ex: Basic, etc.)
            headers[auth_info["key_name"]] = api_choisie["api_key_value"]
    
    # Prépare les query params (pour GET) ou body (pour POST, etc.)
    params = {}
    for op_key, op_value in optional_params.items():
        params[op_key] = op_value
    
    method = endpoint_choisi["method"].upper()
    print(f"Lancement du test de l'endpoint : {method} {url}")
    
    # 6.5 Exécution de la requête
    response = None
    try:
        if method == "GET":
            response = requests.get(url, headers=headers, params=params)
        elif method == "POST":
            response = requests.post(url, headers=headers, json=params)
        elif method == "PUT":
            response = requests.put(url, headers=headers, json=params)
        elif method == "DELETE":
            response = requests.delete(url, headers=headers, json=params)
        else:
            print(f"Méthode {method} non gérée dans cet exemple.")
            return
        
        if response is not None:
            print(f"Statut de la réponse : {response.status_code}")
            print("Corps de la réponse :")
            try:
                print(json.dumps(response.json(), indent=2))
            except:
                print(response.text)
    except Exception as e:
        print(f"Erreur lors de l’appel à l’endpoint : {e}")

# -----------------------------------------------------------------------------
# Fonction principale : menu
def main():
    while True:
        print("=== Menu Principal ===")
        print("1. Ajouter une API (assisté par IA)")
        print("2. Liste des API configurées")
        print("3. Modifier une API")
        print("4. Supprimer une API")
        print("5. Tester un endpoint")
        print("6. Quitter")
        
        choix = input("Choisissez une option : ")
        if choix == '1':
            ajouter_api()
        elif choix == '2':
            lister_apis()
        elif choix == '3':
            modifier_api()
        elif choix == '4':
            supprimer_api()
        elif choix == '5':
            tester_endpoint()
        elif choix == '6':
            print("Au revoir !")
            sys.exit(0)
        else:
            print("Choix invalide.\n")

if __name__ == "__main__":
    main()

3. Explication

1. Menu Principal
   L’utilisateur est guidé par un menu :

   • (1) Ajouter une API via Groq.
   • (2) Lister les API (nom, URL, endpoints).
   • (3) Modifier une API (changer l’URL, la clé, ajouter ou modifier un endpoint, etc.).
   • (4) Supprimer une API (avec confirmation).
   • (5) Tester un endpoint (ex : Spotify).
   • (6) Quitter le programme.

2. Ajout d’API (assisté par IA)

   • Demande de coller la documentation (texte multi-ligne) ou bien de donner une description / URL.
   • Envoie ce texte à l’API Groq via la fonction analyser_api_avec_groq(...), qui génère un JSON décrivant l’API.
   • Si le confidence_score < 0.5, on avertit l’utilisateur qu’on manque d’infos.
   • On enregistre ensuite la configuration.

3. Liste des APIs

   • Affiche toutes les APIs déjà enregistrées (nom, URL de base, endpoints, etc.).

4. Modification d’API

   • En langage naturel, l’utilisateur tape : « Je veux changer la clé » ou « ajouter un endpoint » ou « modifier un endpoint ».
   • Le code interroge l’utilisateur pour connaître les nouvelles valeurs.

5. Suppression d’API

   • Liste d’abord les APIs, puis on peut choisir par nom ou index.
   • Confirme avant de supprimer.

6. Test d’un endpoint (exemple Spotify)

   • On choisit une API, puis un endpoint (ex : /playlists/{playlist_id}/tracks).
   • On saisit la valeur de {playlist_id} et éventuellement market, etc.
   • On exécute une requête HTTP en tenant compte de l’authentification (Bearer token, Basic, etc.).
   • On affiche la réponse (code et JSON).

En suivant ce script, vous pouvez gérer tout le cycle de vie d’une intégration d’API (ajout, modification, suppression, test) avec une aide automatique pour extraire les détails d’API grâce à Groq.

Voici une version améliorée du code qui gère mieux les longs textes de documentation et évite (autant que possible) les erreurs de parsing JSON renvoyées par l’API Groq. Pour cela, nous allons :

1. Tenter d’abord d’envoyer la documentation telle quelle à Groq.
2. Si elle est trop longue ou renvoie une erreur (par exemple "Expecting value: line 1 column 1 (char 0)"), on la découpe en morceaux et on utilise Groq pour produire un résumé automatique (en plusieurs étapes) avant de réanalyser ce résumé pour extraire les informations d’API.

Ainsi, même si l’utilisateur colle un texte très volumineux, on n’envoie à la fin qu’un texte de taille raisonnable à la fonction qui extrait les champs (URL de base, endpoints, etc.). Nous profiterons également de cette occasion pour afficher des messages plus clairs et guider l’utilisateur.

Remarque : La logique de « découpe puis résumé » peut être adaptée à votre convenance. L’exemple ci-dessous illustre une approche basique qui segmente le texte s’il dépasse une certaine taille (par exemple 3000 caractères).

1. Installation

bash
pip install groq

2. Code Complet

Copiez-collez ce script dans un fichier Python (par exemple main.py) et exécutez-le.

python
import sys
import json
import requests

# IMPORTANT : importez le SDK Groq
from groq import Groq

# -----------------------------------------------------------------------------
# Stockage en mémoire des APIs (vous pouvez remplacer par un fichier ou une base de données)
apis_configurees = []

# -----------------------------------------------------------------------------
# CONFIG : seuil de caractères au-delà duquel on tentera un résumé avant l'analyse
MAX_CHARS_DIRECT_ANALYSIS = 3000

# -----------------------------------------------------------------------------
def summarizer_groq(long_text, groq_api_key="gsk_XXXXXXXXXXXXXXX"):
    """
    Si le texte est trop long pour être analysé en une fois, on le découpe et on génère un résumé progressif.
    L'objectif est de réduire le texte à une taille raisonnable pour la suite (analyse des endpoints).
    """
    client = Groq(api_key=groq_api_key)

    # Découpage en chunks de ~3000 caractères pour rester large
    # Vous pouvez ajuster la taille selon vos besoins et limites du modèle.
    chunks = []
    start = 0
    chunk_size = 3000
    while start < len(long_text):
        end = start + chunk_size
        chunks.append(long_text[start:end])
        start = end

    # Maintenant, on génère un résumé pour chaque chunk, puis on combine ces résumés
    summaries = []
    for i, chunk_text in enumerate(chunks, start=1):
        print(f"[INFO] Résumé du chunk {i}/{len(chunks)}...")
        messages = [
            {
                "role": "system",
                "content": (
                    "Tu es un assistant chargé de résumer de la documentation d'API. "
                    "Retourne un résumé concis (quelques phrases) du texte fourni. "
                    "Ne donne pas de structure JSON, juste un résumé en langage naturel."
                )
            },
            {
                "role": "user",
                "content": chunk_text
            }
        ]
        try:
            completion = client.chat.completions.create(
                messages=messages,
                model="llama-3.3-70b-versatile",  # ou un autre modèle
                temperature=0.2,
                max_completion_tokens=1024,
                top_p=1,
                stream=False
            )
            summaries.append(completion.choices[0].message.content.strip())
        except Exception as e:
            print(f"Erreur lors du résumé du chunk {i}: {e}")
            summaries.append("")

    # On combine tous les résumés en un texte plus court
    combined_summary = "\n".join(summaries)
    print("[INFO] Résumé global généré. Longueur du résumé :", len(combined_summary), "caractères.")

    return combined_summary


def analyser_api_avec_groq(input_text, groq_api_key="gsk_XXXXXXXXXXXXXXX"):
    """
    Envoie 'input_text' à l’API Groq via un chat completion,
    pour en extraire un JSON décrivant les informations d'API.
    Le JSON renvoyé doit contenir au moins :
      - api_type (REST, GraphQL, SOAP)
      - base_url
      - auth_info {type, key_name, required}
      - common_headers
      - endpoints (liste)
      - suggested_name
      - rate_limit
      - confidence_score
    """

    # 1) Si le texte est trop long, on le résume d'abord
    text_for_analysis = input_text
    if len(input_text) > MAX_CHARS_DIRECT_ANALYSIS:
        print("[INFO] La documentation est trop volumineuse, on génère un résumé d’abord.")
        text_for_analysis = summarizer_groq(input_text, groq_api_key=groq_api_key)

    # 2) On tente maintenant d'analyser ce texte (ou ce résumé) pour extraire un JSON
    client = Groq(api_key=groq_api_key)

    messages = [
        {
            "role": "system",
            "content": (
                "Tu es un assistant d'analyse d'API. "
                "Retourne un JSON de la forme :\n"
                "{\n"
                "  \"api_type\": \"REST | GraphQL | SOAP\",\n"
                "  \"base_url\": \"string\",\n"
                "  \"auth_info\": {\n"
                "      \"type\": \"string (Bearer, Basic, etc.)\",\n"
                "      \"key_name\": \"string\",\n"
                "      \"required\": true/false\n"
                "  },\n"
                "  \"common_headers\": {\n"
                "      \"Header-Name\": \"Header-Value\"\n"
                "  },\n"
                "  \"endpoints\": [\n"
                "      {\n"
                "          \"name\": \"string\",\n"
                "          \"path\": \"string\",\n"
                "          \"method\": \"GET | POST | ...\",\n"
                "          \"required_params\": [\"param1\", \"param2\"],\n"
                "          \"optional_params\": [\"param1\", \"param2\"],\n"
                "          \"description\": \"string\"\n"
                "      }\n"
                "  ],\n"
                "  \"suggested_name\": \"string\",\n"
                "  \"rate_limit\": \"string\",\n"
                "  \"confidence_score\": 0.x\n"
                "}\n"
                "Analyse le texte ci-après et complète ces champs au mieux."
            )
        },
        {
            "role": "user",
            "content": text_for_analysis
        }
    ]

    try:
        chat_completion = client.chat.completions.create(
            messages=messages,
            model="llama-3.3-70b-versatile",
            temperature=0.0,
            max_completion_tokens=1024,
            top_p=1,
            stream=False,
        )
        
        content = chat_completion.choices[0].message.content
        
        # Tente de parser en JSON
        data = json.loads(content)

        return data

    except Exception as e:
        print(f"[ERREUR] Impossible d'analyser en JSON via Groq : {e}")
        print("[INFO] Nous allons retourner un squelette par défaut.")
        return {
            "api_type": None,
            "base_url": None,
            "auth_info": {
                "type": None,
                "key_name": None,
                "required": False
            },
            "common_headers": {},
            "endpoints": [],
            "suggested_name": "API_Inconnue",
            "rate_limit": None,
            "confidence_score": 0.0
        }

# -----------------------------------------------------------------------------
# 2. Ajout d'une API (assisté par IA)
def ajouter_api():
    print("=== Ajout d’une nouvelle API ===")
    
    # 2.1 Demande à l'utilisateur s'il souhaite coller la documentation
    coller_doc = input("Voulez-vous coller la documentation de l’API ? (o/n) : ")
    
    doc_api = ""
    if coller_doc.lower() == 'o':
        print("Collez la documentation ci-dessous (validez par une ligne vide) :")
        lignes_doc = []
        while True:
            ligne = input()
            if ligne == "":
                break
            lignes_doc.append(ligne)
        doc_api = "\n".join(lignes_doc)
    
    # 2.2 Demandez l’URL ou une description en langage naturel
    url_ou_description = input(
        "Entrez l’URL de l’API ou une description en langage naturel (ou appuyez sur Entrée si tout est dans la doc) : "
    )
    
    # Prépare le texte à analyser (doc + éventuellement une URL/description succincte)
    texte_complet = ""
    if doc_api.strip():
        texte_complet += doc_api.strip()
    if url_ou_description.strip():
        # On sépare par 2 sauts de ligne pour rendre le tout plus lisible
        texte_complet += "\n\n" + url_ou_description.strip()
    
    if not texte_complet:
        print("[ATTENTION] Aucune information fournie, l'analyse risque d'être vide.")
        texte_complet = "Aucune information sur l'API."
    
    # 2.3 Analyse via Groq
    resultats_analyse = analyser_api_avec_groq(texte_complet, groq_api_key="gsk_XXXXXXXXXXXXXXX")
    
    confidence_score = resultats_analyse.get("confidence_score", 0)
    
    # 2.4 Si le score de confiance est faible, on redemande plus d'infos
    if confidence_score < 0.5:
        print("Le score de confiance de l’analyse est faible. "
              "Les informations retournées peuvent être incomplètes ou incorrectes.")
        print("Si besoin, vous pouvez modifier la configuration manuellement après coup.")
    
    # Récupération des champs
    api_type = resultats_analyse.get("api_type")
    base_url = resultats_analyse.get("base_url")
    auth_info = resultats_analyse.get("auth_info", {})
    common_headers = resultats_analyse.get("common_headers", {})
    endpoints = resultats_analyse.get("endpoints", [])
    suggested_name = resultats_analyse.get("suggested_name", "NouvelleAPI")
    rate_limit = resultats_analyse.get("rate_limit")

    print(f"Nom suggéré pour l’API : {suggested_name}")
    nom_api = input(f"Entrez le nom de l’API ({suggested_name}) : ")
    if not nom_api.strip():
        nom_api = suggested_name
    
    # Authentification
    api_key_value = None
    if auth_info.get("required", False):
        api_key_value = input("Entrez la valeur de la clé API ou du token d’authentification : ")
    
    # Construction de la configuration de la nouvelle API
    nouvelle_api = {
        "name": nom_api,
        "type": api_type,
        "base_url": base_url,
        "auth_info": auth_info,
        "api_key_value": api_key_value,
        "common_headers": common_headers,
        "endpoints": endpoints,
        "rate_limit": rate_limit
    }
    
    # 2.5 Enregistrement
    apis_configurees.append(nouvelle_api)
    print(f"\nL’API '{nom_api}' a bien été ajoutée.")
    print(f" - Type : {api_type}")
    print(f" - URL de base : {base_url if base_url else 'Aucune URL détectée'}\n")

# -----------------------------------------------------------------------------
# 3. Lister les API configurées
def lister_apis():
    print("=== Liste des API configurées ===")
    if not apis_configurees:
        print("Aucune API n’est configurée pour le moment.\n")
        return
    
    for i, api in enumerate(apis_configurees, start=1):
        print(f"{i}. Nom : {api['name']}")
        print(f"   URL de base : {api['base_url']}")
        print(f"   Type : {api.get('type')}")
        if api.get("rate_limit"):
            print(f"   Limitation de débit : {api['rate_limit']}")
        if api["endpoints"]:
            print("   Endpoints :")
            for endpoint in api["endpoints"]:
                print(f"     - {endpoint['name']} ({endpoint['method']} {endpoint['path']})")
        else:
            print("   Aucun endpoint configuré.")
        print()
    print()

# -----------------------------------------------------------------------------
# 4. Modifier une API
def modifier_api():
    print("=== Modification d’une API ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 4.1 Affichez la liste des API
    for i, api in enumerate(apis_configurees, start=1):
        print(f"{i}. {api['name']}")
    
    # 4.2 Demandez laquelle modifier (nom ou numéro)
    choix = input("Quelle API souhaitez-vous modifier ? Entrez un nom ou un numéro : ")
    api_choisie = None
    
    # Tente la conversion en entier
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_choisie = apis_configurees[index]
    except ValueError:
        # Sinon on cherche par nom
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_choisie = api
                break
    
    if not api_choisie:
        print("API introuvable.\n")
        return
    
    print(f"\nAPI sélectionnée : {api_choisie['name']}")
    print("Que voulez-vous modifier ? (ex: 'changer l'URL de base', 'mettre à jour la clé API', "
          "'ajouter un endpoint', 'modifier un endpoint', 'supprimer un endpoint')")
    modification = input("> ")
    
    modification_lower = modification.lower()
    
    if "url" in modification_lower:
        nouvelle_url = input("Entrez la nouvelle URL de base : ")
        api_choisie["base_url"] = nouvelle_url
        print("URL de base modifiée avec succès.\n")
    
    if "clé" in modification_lower or "key" in modification_lower:
        nouvelle_cle = input("Entrez la nouvelle clé API : ")
        api_choisie["api_key_value"] = nouvelle_cle
        print("Clé API modifiée avec succès.\n")
    
    if "ajouter un endpoint" in modification_lower:
        print("=== Ajout d'un endpoint ===")
        nom_endpoint = input("Nom du nouvel endpoint : ")
        path_endpoint = input("Chemin (ex: /playlists/{playlist_id}/tracks) : ")
        methode = input("Méthode HTTP (GET, POST, etc.) : ")
        params_requis = input("Paramètres requis (séparés par des virgules) : ").split(",")
        params_op = input("Paramètres optionnels (séparés par des virgules) : ").split(",")
        
        nouveau_endpoint = {
            "name": nom_endpoint,
            "path": path_endpoint,
            "method": methode.upper(),
            "required_params": [p.strip() for p in params_requis if p.strip()],
            "optional_params": [p.strip() for p in params_op if p.strip()],
            "description": ""
        }
        api_choisie["endpoints"].append(nouveau_endpoint)
        print(f"Endpoint '{nom_endpoint}' ajouté.\n")
    
    if "modifier un endpoint" in modification_lower:
        print("=== Modification d'un endpoint existant ===")
        for i, ep in enumerate(api_choisie["endpoints"], start=1):
            print(f"{i}. {ep['name']} ({ep['method']} {ep['path']})")
        choix_ep = input("Quel endpoint souhaitez-vous modifier ? (numéro ou nom) : ")
        
        endpoint_choisi = None
        try:
            ep_index = int(choix_ep) - 1
            if 0 <= ep_index < len(api_choisie["endpoints"]):
                endpoint_choisi = api_choisie["endpoints"][ep_index]
        except ValueError:
            for ep in api_choisie["endpoints"]:
                if ep["name"].lower() == choix_ep.lower():
                    endpoint_choisi = ep
                    break
        
        if not endpoint_choisi:
            print("Endpoint introuvable.")
            return
        
        print(f"Endpoint sélectionné : {endpoint_choisi['name']}")
        action_modif = input("Que voulez-vous modifier ? (ex: 'ajouter un paramètre', 'changer la méthode', etc.) : ")
        
        if "ajouter un paramètre" in action_modif.lower():
            nom_param = input("Nom du paramètre : ")
            type_param = input("Paramètre requis ou optionnel ? (r/o) : ")
            if type_param.lower() == "r":
                endpoint_choisi["required_params"].append(nom_param)
                print(f"Le paramètre requis '{nom_param}' a été ajouté.")
            else:
                endpoint_choisi["optional_params"].append(nom_param)
                print(f"Le paramètre optionnel '{nom_param}' a été ajouté.")
    
    if "supprimer un endpoint" in modification_lower:
        print("=== Suppression d'un endpoint ===")
        for i, ep in enumerate(api_choisie["endpoints"], start=1):
            print(f"{i}. {ep['name']} ({ep['method']} {ep['path']})")
        choix_ep = input("Quel endpoint souhaitez-vous supprimer ? (numéro ou nom) : ")
        
        ep_a_supprimer = None
        try:
            ep_index = int(choix_ep) - 1
            if 0 <= ep_index < len(api_choisie["endpoints"]):
                ep_a_supprimer = api_choisie["endpoints"][ep_index]
        except ValueError:
            for ep in api_choisie["endpoints"]:
                if ep["name"].lower() == choix_ep.lower():
                    ep_a_supprimer = ep
                    break
        
        if ep_a_supprimer:
            api_choisie["endpoints"].remove(ep_a_supprimer)
            print(f"L’endpoint '{ep_a_supprimer['name']}' a été supprimé.")
        else:
            print("Endpoint introuvable.")
    
    print("Modification(s) terminée(s).\n")

# -----------------------------------------------------------------------------
# 5. Supprimer une API
def supprimer_api():
    print("=== Suppression d’une API ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 5.1 Liste des API
    for i, api in enumerate(apis_configurees, start=1):
        print(f"{i}. {api['name']}")
    
    # 5.2 Demandez laquelle supprimer (nom ou numéro)
    choix = input("Quelle API souhaitez-vous supprimer ? (nom ou numéro) : ")
    
    api_a_supprimer = None
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_a_supprimer = apis_configurees[index]
    except ValueError:
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_a_supprimer = api
                break
    
    if not api_a_supprimer:
        print("API introuvable.\n")
        return
    
    # 5.3 Confirmation
    confirm = input(f"Êtes-vous sûr de vouloir supprimer l’API {api_a_supprimer['name']} ? (o/n) : ")
    if confirm.lower() == 'o':
        apis_configurees.remove(api_a_supprimer)
        print(f"L’API {api_a_supprimer['name']} a été supprimée.\n")
    else:
        print("Opération annulée.\n")

# -----------------------------------------------------------------------------
# 6. Tester un Endpoint (Exemple avec Spotify)
def tester_endpoint():
    print("=== Tester un endpoint ===")
    if not apis_configurees:
        print("Aucune API n’est configurée.\n")
        return
    
    # 6.1 Sélection de l’API
    for i, api in enumerate(apis_configurees, start=1):
        print(f"{i}. {api['name']}")
    choix = input("Sur quelle API souhaitez-vous tester un endpoint ? (nom ou numéro) : ")
    
    api_choisie = None
    try:
        index = int(choix) - 1
        if 0 <= index < len(apis_configurees):
            api_choisie = apis_configurees[index]
    except ValueError:
        for api in apis_configurees:
            if api["name"].lower() == choix.lower():
                api_choisie = api
                break
    
    if not api_choisie:
        print("API introuvable.\n")
        return
    
    # 6.2 Sélection de l’endpoint
    if not api_choisie["endpoints"]:
        print(f"L’API {api_choisie['name']} n’a aucun endpoint configuré.\n")
        return
    
    print(f"Endpoints disponibles pour {api_choisie['name']} :")
    for i, ep in enumerate(api_choisie["endpoints"], start=1):
        print(f"{i}. {ep['name']} ({ep['method']} {ep['path']})")
    choix_ep = input("Quel endpoint souhaitez-vous tester ? (numéro ou nom) : ")
    
    endpoint_choisi = None
    try:
        ep_index = int(choix_ep) - 1
        if 0 <= ep_index < len(api_choisie["endpoints"]):
            endpoint_choisi = api_choisie["endpoints"][ep_index]
    except ValueError:
        for ep in api_choisie["endpoints"]:
            if ep["name"].lower() == choix_ep.lower():
                endpoint_choisi = ep
                break
    
    if not endpoint_choisi:
        print("Endpoint introuvable.")
        return
    
    # Exemple concret pour Spotify :
    #  - Lire une playlist : param requis => playlist_id
    #  - Vérifier si une musique est dans une playlist : param requis => playlist_id, track_id
    
    # 6.3 Récupération des paramètres (required et optional)
    required_params = {}
    for rp in endpoint_choisi.get("required_params", []):
        required_params[rp] = input(f"Entrez la valeur pour '{rp}' : ")
    
    optional_params = {}
    for op in endpoint_choisi.get("optional_params", []):
        val = input(f"Entrez la valeur (ou laissez vide) pour le paramètre optionnel '{op}' : ")
        if val:
            optional_params[op] = val
    
    # 6.4 Construction de l’URL
    base_url = api_choisie["base_url"]
    path = endpoint_choisi["path"]
    # Remplace les variables {param} dans le path
    for rp_key, rp_value in required_params.items():
        path = path.replace(f"{{{rp_key}}}", rp_value)
    url = base_url + path if base_url else path
    
    # Prépare les en-têtes
    headers = dict(api_choisie["common_headers"])
    auth_info = api_choisie.get("auth_info", {})
    if auth_info.get("required") and api_choisie.get("api_key_value"):
        # Si c'est un Bearer
        if auth_info["type"] and "bearer" in auth_info["type"].lower():
            bearer_token = api_choisie["api_key_value"]
            key_name = auth_info.get("key_name", "Authorization")
            headers[key_name] = f"Bearer {bearer_token}"
        else:
            # Basic ou autre
            key_name = auth_info.get("key_name", "Authorization")
            headers[key_name] = api_choisie["api_key_value"]
    
    # Prépare les query params (GET, etc.) / body (POST, etc.)
    params = {}
    for op_key, op_value in optional_params.items():
        params[op_key] = op_value
    
    method = endpoint_choisi["method"].upper()
    print(f"\nLancement du test de l'endpoint : {method} {url}")
    print(f"En-têtes : {headers}")
    print(f"Paramètres : {params}\n")
    
    # 6.5 Exécution de la requête
    response = None
    try:
        if method == "GET":
            response = requests.get(url, headers=headers, params=params)
        elif method == "POST":
            response = requests.post(url, headers=headers, json=params)
        elif method == "PUT":
            response = requests.put(url, headers=headers, json=params)
        elif method == "DELETE":
            response = requests.delete(url, headers=headers, json=params)
        else:
            print(f"Méthode {method} non gérée dans cet exemple.")
            return
        
        if response is not None:
            print(f"Statut de la réponse : {response.status_code}")
            print("Corps de la réponse :")
            try:
                print(json.dumps(response.json(), indent=2))
            except:
                print(response.text)
    except Exception as e:
        print(f"Erreur lors de l’appel à l’endpoint : {e}")

# -----------------------------------------------------------------------------
# Fonction principale : menu
def main():
    while True:
        print("=== Menu Principal ===")
        print("1. Ajouter une API (assisté par IA)")
        print("2. Liste des API configurées")
        print("3. Modifier une API")
        print("4. Supprimer une API")
        print("5. Tester un endpoint")
        print("6. Quitter")
        
        choix = input("Choisissez une option : ")
        if choix == '1':
            ajouter_api()
        elif choix == '2':
            lister_apis()
        elif choix == '3':
            modifier_api()
        elif choix == '4':
            supprimer_api()
        elif choix == '5':
            tester_endpoint()
        elif choix == '6':
            print("Au revoir !")
            sys.exit(0)
        else:
            print("Choix invalide.\n")

if __name__ == "__main__":
    main()