API Documentation

Cette section contient la documentation détaillée de l’API.

API Reference

Cette section détaille les endpoints de l’API et leur utilisation.

Endpoint /ask

ask_question(question: Question) → Response

Endpoint principal pour poser une question à l’API.

Parameters:: question (Question) – Un objet Question contenant le texte de la question
Returns:: Un objet Response contenant la réponse, le niveau de confiance et les informations Discogs
Return type:: Response
Raises:: HTTPException – En cas d’erreur lors du traitement de la requête

Exemple d’utilisation:

import httpx

async with httpx.AsyncClient() as client:
    response = await client.post(
        "http://localhost:8000/ask",
        json={"text": "Quel est le premier album de Pink Floyd?"}
    )
    data = response.json()

Le processus de traitement se déroule en trois étapes :

Analyse de la question avec Claude pour extraire les informations musicales
Recherche dans la base de données Discogs
Génération de la réponse finale avec Claude

La réponse inclut :

La réponse textuelle à la question
Un score de confiance basé sur les résultats Discogs
Les informations musicales extraites de la question