Obtenir la liste Q&R

Récupérez la liste des questions-réponses à partir de l'historique de chat de l'Agent.

Méthode de requête

GET

URL de la requête

https://api.gptbots.ai/v1/message/qa/record/page

Authentification de la requête

Consultez la section Présentation pour les détails d'authentification.

Requête

Exemple de requête

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/message/qa/record/page?page=1&page_size=10&start_time=1732982400000&end_time=1735660799999&user_feedback=ALL' \ -H 'Authorization: Bearer ${API Key}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/message/qa/record/page?page=1&page_size=10&start_time=1732982400000&end_time=1735660799999&user_feedback=ALL' \
-H 'Authorization: Bearer ${API Key}'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Bearer ${API Key}	Utilisez Authorization: Bearer ${API Key} pour l'authentification. Obtenez la clé API depuis la page Clé API.

Corps de la requête

Champ	Type	Obligatoire	Description
user_feedback	String	Oui	Retour utilisateur. ALL : Tous. NONE : Aucun retour. GOOD : Retour positif, likes, éloges. BAD : Retour négatif, dislikes, plaintes.
start_time	Long	Oui	Heure de début de la plage de requête, au format timestamp. L'objet de la requête est l'heure des questions (Q) dans Q&R.
end_time	Long	Oui	Heure de fin de la plage de requête, au format timestamp. L'objet de la requête est l'heure des questions (Q) dans Q&R.
page	Integer	Oui	Numéro de page, à partir de 1.
page_size	Integer	Oui	Nombre de documents par page. Indiquez une valeur entre 10 et 100.

Réponse

Exemple de réponse

{ "qa": [ { "id": "xxxxxx", "q_time": 1699891200, "q": "xxxxxx", "a": "xxxxxx", "user_feedback": "GOOD", "convo_id": "xxxxxx", "convo_type": "API", "aid": "xxxxxx", "user_id": "xxxxxx" }, { "id": "xxxxxx", "q_time": 1699891214, "q": "xxxxxx", "a": "xxxxxx", "user_feedback": "BAD", "convo_id": "xxxxxx", "convo_type": "API", "aid": "xxxxxx", "user_id": "xxxxxx" } ] }

                      
                      {
    "qa": [
        {
            "id": "xxxxxx",
            "q_time": 1699891200,
            "q": "xxxxxx",
            "a": "xxxxxx",
            "user_feedback": "GOOD",
            "convo_id": "xxxxxx",
            "convo_type": "API",
            "aid": "xxxxxx",
            "user_id": "xxxxxx"
        },
        {
            "id": "xxxxxx",
            "q_time": 1699891214,
            "q": "xxxxxx",
            "a": "xxxxxx",
            "user_feedback": "BAD",
            "convo_id": "xxxxxx",
            "convo_type": "API",
            "aid": "xxxxxx",
            "user_id": "xxxxxx"
        }
    ]
}

Ce bloc de code dans la fenêtre flottante

Réponse en cas de succès

Nom du champ	Type	Description
qa	Array<Object>	Liste des Q&R.
id	String	ID de la Q&R.
q_time	Long	Horodatage de l'émission de la question (Q).
q	String	Contenu de la question.
a	String	Contenu de la réponse.
user_feedback	String	Retour utilisateur.
convo_id	String	ID de la conversation associée.
convo_type	String	Type de la conversation associée.
user_id	String	ID utilisateur. Un ID personnalisé marqué par le développeur de l'agent via des moyens tiers, utilisé pour identifier l'identité spécifique de l'utilisateur.

Réponse en cas d'échec

Champ	Type	Description
code	Int	Code d'erreur.
message	String	Détails de l'erreur.