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
uniqueactivée ne peut pas dépasser 256 caractères.- La longueur de la valeur d'un champ sans l'option
uniqueactivé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 |
