Supprimer des données de table

Cette API vous permet de supprimer en lot des enregistrements spécifiés des tables de base de données Agent, avec une limite maximale de 1000 enregistrements par requête.

Méthode de requête

POST

URL de la requête

https://api-${endpoint}/v2/database/delete/record

Authentification

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

Requête

Exemple de requête

curl -X POST 'https://api-${endpoint}/v2/database/delete/record' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "delete_data":[ { "record_id":"123456" }, { "filter": { "id": "789" } } ] }'

                      
                      curl -X POST 'https://api-${endpoint}/v2/database/delete/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
      "table_id": "673af861ed69656ac0895b07",
      "delete_data":[
        {
          "record_id":"123456"
        },
        {  
          "filter": {
            "id": "789"
          }
        }
      ]
    }'

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 votre clé API depuis la page Clés API.
Content-Type	application/json	Type de données, doit être application/json.

Corps de la requête

Champ	Type	Obligatoire	Description
table_id	string	Oui	L'identifiant de la table.
delete_data	array	Oui	Tableau des enregistrements à supprimer.
record_id	string	Non	Choisissez soit record_id soit une condition de filtre. record_id est recommandé.
filter	map	Non	Conditions de filtre personnalisées (doit utiliser des champs de clé primaire uniques personnalisés).

Remarque : Vous devez spécifier soit record_id soit une condition de filtre, record_id étant l'option recommandée. Lorsque les deux sont fournis, record_id est prioritaire.

Réponse

Exemple de réponse

{ "code": 0, "message": "OK" }

                      
                      {
    "code": 0,
    "message": "OK"
}

Ce bloc de code dans la fenêtre flottante

Réponse réussie

Champ	Type	Description
code	int	Code de réponse indiquant le type de message.
message	string	Description du message de réponse.

Réponse d'erreur

Champ	Type	Description
code	int	Code d'erreur.
message	string	Message d'erreur détaillé.

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