Crear tabla de base de datos

Esta API permite crear nuevas tablas de base de datos y sus campos para el agente.

Método de solicitud

POST

Endpoint

https://api-${endpoint}.gptbots.ai/v1/database/create-table

Autenticación

Para obtener más información, consulte la descripción del método de autenticación en Visión general de la API.

Solicitud

Ejemplo de solicitud

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/create-table' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "name": "test_api", "description": "Test all database APIs", "fields": [ { "name": "id", "description": "id", "type": "TEXT", "required": true, "unique": true }, { "name": "boolean", "description": "boolean", "type": "BOOLEAN", "required": true, "unique": false }, { "name": "int", "description": "int", "type": "INT", "required": true, "unique": true }, { "name": "datetime", "description": "datetime", "type": "DATETIME", "required": true, "unique": false }, { "name": "float", "description": "float", "type": "FLOAT", "required": false, "unique": false } ] }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/create-table' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
    "name": "test_api",
    "description": "Test all database APIs",
    "fields": [
        {
            "name": "id",
            "description": "id",
            "type": "TEXT",
            "required": true,
            "unique": true
        },
        {
            "name": "boolean",
            "description": "boolean",
            "type": "BOOLEAN",
            "required": true,
            "unique": false
        },
        {
            "name": "int",
            "description": "int",
            "type": "INT",
            "required": true,
            "unique": true
        },
        {
            "name": "datetime",
            "description": "datetime",
            "type": "DATETIME",
            "required": true,
            "unique": false
        },
        {
            "name": "float",
            "description": "float",
            "type": "FLOAT",
            "required": false,
            "unique": false
        }
    ]
}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

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

Parámetros de la solicitud

Campo	Tipo	Obligatorio	Descripción
name	string	Sí	Nombre de la tabla: 64 caracteres, a–z, números y guiones bajos, comenzando por una letra.
description	string	Sí	Descripción de la tabla: 128 caracteres, para ayudar al LLM a comprender la estructura de datos de la tabla.
fields	array	Sí	Matriz de campos de la tabla.
fields[].name	string	Sí	Nombre del campo: 64 caracteres, a–z, números y guiones bajos.
fields[].description	string	Sí	Descripción del campo: 128 caracteres, para ayudar al LLM a comprender la estructura de datos de la tabla.
fields[].type	string	Sí	Tipo de datos: TEXT/INT/FLOAT/DATETIME/BOOLEAN.
fields[].required	boolean	No	Obligatorio: true/false.
fields[].unique	boolean	No	Único: true/false.

Respuesta

Ejemplo de respuesta

"673e9c7a9f7bc178002dbce8"

                      
                      "673e9c7a9f7bc178002dbce8"

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
code	int	Código del tipo de mensaje.
message	string	Descripción del mensaje.
data	object	Contenido de la respuesta; el identificador único de la tabla de datos.

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	Parámetros no válidos
40008	Se ha superado el límite de solicitudes RPM del agente. Póngase en contacto con el proveedor del servicio para aumentar el límite.
40127	Error de autenticación del desarrollador
40353	Esta función solo está disponible tras actualizar su plan
403100	Nombre de tabla no válido
403103	Nombre de campo no válido
50000	Error interno del sistema