logo
Desarrollo
Buscar
Añadir datos a la tabla

Añadir datos a la tabla

Esta API permite añadir hasta 1000 filas de datos en una sola operación en la tabla de datos del agente especificado para su uso y consulta en las conversaciones.

Nota:

  • La longitud del valor del campo con unique activado no puede superar los 256 caracteres.
  • La longitud del valor del campo sin unique activado no puede superar los 4294967295 caracteres (en la práctica está limitada por la red; se recomienda limitar la longitud de los datos).
  • Los datos transmitidos a través de la API se convertirán a formato CSV. El tamaño del archivo CSV no debe superar los 10 MB.

Método de la solicitud

POST

Endpoint

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

Autenticación

Consulte la Visión general de la API para conocer el método de autenticación.

Solicitud

Ejemplo de solicitud

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"
        }
    ]
}'

                    
Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo Tipo Descripción
Authorization Bearer ${API Key} Se usa Authorization: Bearer ${API Key} para la autenticación. La clave de API se obtiene en la página «API Key».
Content-Type application/json Tipo de contenido; se establece en application/json.

Importante:

  • Cuando haya campos únicos en la tabla de datos, todos los campos únicos deben incluirse en los registros.
  • Los valores de los campos únicos en los registros no deben estar duplicados ni vacíos, ni existir ya en la base de datos; de lo contrario, se producirá un error y se descartarán los datos.

Cuerpo de la solicitud

Campo Tipo Obligatorio Descripción
records array Conjunto de registros que se van a importar.
table_id string ID de la tabla.

Respuesta

Ejemplo de respuesta

"673e9cda9f7bc178002dbd9c"
                      
                      "673e9cda9f7bc178002dbd9c"

                    
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.
data object ID de la tarea de esta operación de adición de datos a la tabla; solo se devuelve un ID.

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