logo
Développement
AperçuEspaceDéveloppementEspaceDeTravailRéférenceAPIMeilleurePratiqueJournalDesModifications
Rechercher
Français
RéférenceAPI / APIBaseDeDonnées / InterrogerStatutAjoutDonnéesTable
Vérifier le statut de l'ajout de données à une table
Dernière mise à jour：4 months ago

Vérifier le statut de l'ajout de données à une table

Utilisez cette API pour interroger le statut de traitement des tâches d'ajout de données à une table.

Méthode de requête

GET

Endpoint

https://api-${endpoint}.gptbots.ai/v1/database/query/import-results

Authentification

Consultez la description de la méthode d'authentification dans la Présentation de l'API pour plus de détails.

Requête

Exemple de requête

curl -X GET 'https://api-${endpoint}/v1/database/query/import-results?ids=68ec7ad3e307920f002648cd' \ -H 'Authorization: Bearer ${API Key}'
                      
                      curl -X GET 'https://api-${endpoint}/v1/database/query/import-results?ids=68ec7ad3e307920f002648cd' \
-H 'Authorization: Bearer ${API Key}'
Ce bloc de code dans la fenêtre flottante

En-têtes de 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.

Paramètres de requête

Champ Type Obligatoire Description
ids liste Oui Liste des identifiants de tâches d'ajout de données.

Réponse

Exemple de réponse

[ { "id": "68ec7ad3e307920f002648cd", "progress": 1, "status": "FAIL", "total_count": 4, "success_count": 0, "fail_count": 4, "fail_detail": [ { "row": null, "row_number_start": 1, "row_number_end": 2, "fail_reason": "(1062, \"Entrée en double '14' pour la clé 'product_feed_090833.id'\")" }, { "row": 2, "row_number_start": 0, "row_number_end": 0, "fail_reason": "`id` doit être unique, mais la valeur '14' est dupliquée (première occurrence à la ligne `1`)." }, { "row": 4, "row_number_start": 0, "row_number_end": 0, "fail_reason": "`no` est requis et doit avoir une valeur ; la valeur actuelle est invalide ou la propriété est manquante. `no` doit être unique, mais la valeur est vide ou la propriété est manquante." } ] } ]
                      
                      [
    {
        "id": "68ec7ad3e307920f002648cd",
        "progress": 1,
        "status": "FAIL",
        "total_count": 4,
        "success_count": 0,
        "fail_count": 4,
        "fail_detail": [
            {
                "row": null,
                "row_number_start": 1,
                "row_number_end": 2,
                "fail_reason": "(1062, \"Entrée en double '14' pour la clé 'product_feed_090833.id'\")"
            },
            {
                "row": 2,
                "row_number_start": 0,
                "row_number_end": 0,
                "fail_reason": "`id` doit être unique, mais la valeur '14' est dupliquée (première occurrence à la ligne `1`)."
            },
            {
                "row": 4,
                "row_number_start": 0,
                "row_number_end": 0,
                "fail_reason": "`no` est requis et doit avoir une valeur ; la valeur actuelle est invalide ou la propriété est manquante. `no` doit être unique, mais la valeur est vide ou la propriété est manquante."
            }
        ]
    }
]
Ce bloc de code dans la fenêtre flottante

Réponse réussie

Champ Type Description
id string Identifiant unique de la tâche.
progress int Pourcentage d'avancement de la tâche, compris entre 1 et 100.
status string Statut de la tâche. "FAIL" signifie échec, "PENDING_PARSE" signifie que le fichier est en cours d'analyse, et "AVAILABLE" signifie qu'au moins un enregistrement a été ajouté avec succès.
total_count int Nombre total d'éléments traités.
success_count int Nombre d'éléments traités avec succès.
fail_count int Nombre d'éléments en échec.
fail_detail Array<Object> Positions et raisons des échecs d'ajout.
row int Indique le numéro de ligne où l'erreur s'est produite. Si null, l'erreur ne peut pas être associée à une ligne spécifique.
row_number_start int Indique le début de la plage d'erreur (par blocs de dix lignes).
row_number_end int Indique la fin de la plage d'erreur (par blocs de dix lignes).
fail_reason string Description de la raison de l'erreur.

Réponse en échec

Champ Type Description
code int Code d'erreur.
message string Détails de l'erreur.

Codes d'erreur

Code Message
50000 Erreur interne du système

Comment interpréter la réponse ?

  1. Cas d'échec 1 : Si les données importées sont en conflit avec celles déjà présentes dans la table de données, aucune donnée ne sera importée.

    • Le "fail_count" sera égal à "total_count".
    • "row" sera null.
    • Dans ce cas, consultez "fail_reason" pour identifier le problème.
    • "row_number_start" et "row_number_end" peuvent ne pas correspondre aux numéros de lignes réels, ils peuvent donc être ignorés.

  2. Cas d'échec 2 : S'il y a un conflit dans les données importées elles-mêmes, le premier enregistrement en conflit sera importé, et le second sera rejeté.

    • "row" indiquera le numéro de ligne du second enregistrement en conflit.
    • "row_number_start" et "row_number_end" seront à 0.

  3. Autres échecs : Si les données importées ne respectent pas le format ou les règles requises, cet enregistrement ne sera pas importé.

    • "row" indiquera le numéro de ligne de l'enregistrement invalide.
    • "row_number_start" et "row_number_end" seront à 0.