logo
Développement
Rechercher
Ajouter des données à une table

Ajouter des données à une table

Cette API permet d'ajouter jusqu'à 1000 lignes de données en une seule opération à la table de données de l'agent spécifié, pour une utilisation et une interrogation dans les conversations.

Remarque :

  • La longueur de la valeur d'un champ avec l'option unique activée ne peut pas dépasser 256 caractères.
  • La longueur de la valeur d'un champ sans l'option unique activée ne peut pas dépasser 4294967295 caractères (en réalité limitée par des problèmes de réseau, il est recommandé de contrôler la longueur des données).
  • Les données transmises via l'API seront converties au format CSV. La taille du fichier CSV ne doit pas dépasser 10 Mo.

Méthode de requête

POST

Endpoint

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

Authentification

Consultez la Présentation de l'API pour l'explication de la méthode d'authentification.

Requête

Exemple de requête

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/import/records' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "records": [ { "id": "7424489", "name": "4455566777777" }, { "id": "7852549", "name": "446656677665" } ] }'
                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/import/records' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
    "table_id": "673af861ed69656ac0895b07",
    "records": [
        {
                "id": "7424489",
                "name": "4455566777777"
        }, 
        {
                "id": "7852549",
                "name": "446656677665"
        }
    ]
}'

                    
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.
Content-Type application/json Type de données, à définir sur application/json.

Important :

  • Lorsque des champs uniques existent dans la table de données, tous les champs uniques doivent être inclus dans les enregistrements.
  • Les valeurs des champs uniques dans les enregistrements ne doivent pas être dupliquées, vides ou déjà présentes dans la base de données, sinon une erreur se produira et les données seront rejetées.

Corps de la requête

Champ Type Obligatoire Description
records liste Oui La collection de données à importer.
table_id chaîne Oui ID de la table.

Réponse

Exemple de réponse

"673e9cda9f7bc178002dbd9c"
                      
                      "673e9cda9f7bc178002dbd9c"

                    
Ce bloc de code dans la fenêtre flottante

Réponse réussie

Champ Type Description
code int Code du type de message.
message chaîne Description du message.
data objet L'ID de la tâche pour cette opération d'ajout de données à la table, un seul ID sera retourné.

Réponse en cas d'échec

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

Codes d'erreur

Code Message
40000 Erreur de paramètre
50000 Erreur interne du système