Mettre à jour les données de table

Cette API vous permet de mettre à jour en lot des enregistrements spécifiés dans les tables de base de données Agent, avec un maximum de 100 enregistrements par requête.

Remarque :
La taille totale du corps de la requête JSON (corps de la requête) est limitée à 5 Mo.
Chaque requête peut mettre à jour jusqu'à 100 enregistrements.

Méthode de requête

POST

URL de la requête

https://api-${endpoint}gptbots.ai/v2/database/update/record

Authentification

Pour plus de détails sur l'authentification, veuillez consulter la Présentation de l'API.

Requête

Exemple de requête

curl -X POST 'https://api-${endpoint}gptbots.ai/v2/database/update/record' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "is_create": true, "update_data":[ { "record_id":"123456", "updated_fields": { "name": "andy", "age": "30" } }, { "filter": { "id": "789" }, "updated_fields": { "name": "mop", "age": "32" } } ] }'

                      
                      curl -X POST 'https://api-${endpoint}gptbots.ai/v2/database/update/record' \ 
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
      "table_id": "673af861ed69656ac0895b07",
      "is_create": true,
      "update_data":[
        {
          "record_id":"123456",
          "updated_fields": {
          "name": "andy",
          "age": "30"
          }
        },
        {
          "filter": {
            "id": "789"
          },
          "updated_fields": {
          "name": "mop",
          "age": "32"
          }
        }
      ]
    }'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Bearer ${API Key}	Authentification via `Authorization: Bearer ${API Key}`. Obtenez votre clé API sur la page des clés API.
Content-Type	application/json	Format des données, doit être application/json.

Corps de la requête

Champ	Type	Obligatoire	Description
table_id	string	Oui	ID de la table.
is_create	bool	Non	Indique s'il faut créer un nouvel enregistrement lorsque l'enregistrement cible spécifié n'existe pas.
update_data	list	Oui	La collection de données à mettre à jour.
record_id	string	Non	Soit `record_id` soit `filter` doit être fourni. `record_id` est recommandé.
filter	map	Non	Condition de filtre définie par l'utilisateur. Doit inclure un champ avec `"unique": true`. Un seul champ est pris en charge.
updated_fields	list	Oui	La collection des champs à mettre à jour.

Remarque

Soit record_id soit filter doit être fourni. Lorsque les deux sont transmis, record_id est prioritaire.

La valeur par défaut de is_create est false.

Lorsque is_create n'est pas fourni, aucun nouvel enregistrement ne sera créé automatiquement.

Lorsque is_create est défini sur true, si le record_id ou le filter d'un enregistrement à mettre à jour n'existe pas dans la table de données, l'enregistrement sera automatiquement créé.

Réponse

Exemple de réponse

{ "totalCount": 4, "success_count": 2, "fail_count": 2, "fail_detail": [ { "upsert_data": { "record_id": "123456", "value": { "name": "test user", "email": "invalid_email" } }, "fail_reason": "Format d'email invalide" }, { "upsert_data": { "filter": { "id": "789" }, "value": { "name": "test user", "email": "invalid_email" } }, "fail_reason": "Format d'email invalide" } ] }

                      
                      {
    "totalCount": 4,
    "success_count": 2,
    "fail_count": 2,
    "fail_detail": [
        {
            "upsert_data": {
                "record_id": "123456",
                "value": {
                    "name": "test user",
                    "email": "invalid_email"
                }
            },
            "fail_reason": "Format d'email invalide"
        },
        {
            "upsert_data": {
                "filter": {
                    "id": "789"
                },
                "value": {
                    "name": "test user",
                    "email": "invalid_email"
                }
            },
            "fail_reason": "Format d'email invalide"
        }
    ]
}

Ce bloc de code dans la fenêtre flottante

Réponse réussie

Champ	Type	Description
totalCount	int	Nombre total d'enregistrements dans cette opération de mise à jour
success_count	string	Nombre d'enregistrements mis à jour avec succès
fail_count	string	Nombre d'opérations de mise à jour échouées
fail_detail	array	Informations détaillées sur les mises à jour échouées
upsert_data	array	Données de requête pour cette opération de mise à jour échouée
fail_reason	array	Raison de l'échec de la mise à jour

Réponse d'erreur

Champ	Type	Description
code	int	Code d'erreur
message	string	Description du message d'erreur

Codes d'erreur

Code	Message
40000	Paramètres invalides
50000	Erreur interne du système
403106	Table non trouvée
403131	Pas d'autorisation pour accéder à la table