Actualizar datos de tabla

Esta interfaz permite actualizar los valores de registros específicos en la tabla de datos del agente.

Método de solicitud

POST

Endpoint

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

Autenticación

Para más información, se pueden consultar los métodos de autenticación en Visión general de la API (API Overview).

Solicitud

Ejemplo de solicitud

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/update/record' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "record_id": "123456", "filter": { "id": "789" }, "updated_fields": { "name": "99990", "age": "30" }, "is_add": false }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/update/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
  "table_id": "673af861ed69656ac0895b07",
  "record_id": "123456",
  "filter": {
    "id": "789"
  },
  "updated_fields": {
    "name": "99990",
    "age": "30"
  },
  "is_add": false
}'

Este bloque de código en una ventana flotante

Encabezados de solicitud

Campo	Tipo	Descripción
Authorization	Bearer ${API Key}	Para autenticarse, se utiliza `Authorization: Bearer ${API Key}`. La API Key se obtiene en la página API Key.
Content-Type	application/json	Tipo de datos; el valor es `application/json`.

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
table_id	string	Sí	ID de la tabla.
record_id	string	No	ID del registro o condición de filtro; se debe elegir una de las dos opciones. Se recomienda usar el ID del registro.
filter	map	No	Condiciones de filtro personalizadas (deben usarse campos personalizados con clave primaria única).
updated_fields	map	Sí	Conjunto de datos que se van a actualizar.
is_add	boolean	No	Indica si se debe añadir un nuevo registro si el registro de destino no existe.

Respuesta

Ejemplo de respuesta

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

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

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
code	int	Código de tipo del mensaje.
message	string	Descripción del mensaje.

Respuesta de error

Campo	Tipo	Descripción
code	int	Código de error.
message	string	Detalles del error.

Códigos de error

Código	Mensaje
40000	Error de parámetros
50000	Error interno del sistema
403106	Tabla no encontrada
403131	Sin acceso a la tabla de datos