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
uniqueactivado no puede superar los 256 caracteres.- La longitud del valor del campo sin
uniqueactivado 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 | Sí | Conjunto de registros que se van a importar. |
| table_id | string | Sí | 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 |
