Datenbanktabelle erstellen

Mit dieser API können Sie neue Datenbanktabellen und deren Felder für Ihren Agenten erstellen.

HTTP-Anfragemethode

POST

Endpoint

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

Authentifizierung

Weitere Informationen zur Authentifizierung finden Sie im Abschnitt zur Authentifizierungsmethode im API-Überblick.

Anfrage

Beispielanfrage

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 sämtlicher Datenbank-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 sämtlicher Datenbank-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
        }
    ]
}'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Verwenden Sie `Authorization: Bearer ${API Key}` zur Authentifizierung. Den API Key erhalten Sie auf der API Key-Seite.
Content-Type	application/json	Datentyp, muss auf `application/json` gesetzt werden.

Anfrageparameter

Feld	Typ	Erforderlich	Beschreibung
name	string	Ja	Tabellenname: bis zu 64 Zeichen, Buchstaben (a–z), Zahlen und Unterstriche erlaubt, muss mit einem Buchstaben beginnen.
description	string	Ja	Tabellenbeschreibung: bis zu 128 Zeichen, unterstützt das LLM beim Verständnis der Tabellenstruktur.
fields	array	Ja	Array der Tabellenfelder.
fields[].name	string	Ja	Feldname: bis zu 64 Zeichen, Buchstaben (a–z), Zahlen und Unterstriche erlaubt.
fields[].description	string	Ja	Feldbeschreibung: bis zu 128 Zeichen, unterstützt das LLM beim Verständnis der Feldstruktur.
fields[].type	string	Ja	Datentyp: TEXT / INT / FLOAT / DATETIME / BOOLEAN.
fields[].required	boolean	Nein	Erforderlich: true / false.
fields[].unique	boolean	Nein	Eindeutig: true / false.

Antwort

Beispielantwort

"673e9c7a9f7bc178002dbce8"

                      
                      "673e9c7a9f7bc178002dbce8"

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
code	int	Nachrichtentyp-Code.
message	string	Nachrichtenbeschreibung.
data	object	Antwortinhalt: Die eindeutige Kennung der Datentabelle.

Fehlerantwort

Feld	Typ	Beschreibung
code	int	Fehlercode.
message	string	Fehlerdetails.

Fehlercodes

Code	Nachricht
40000	Ungültige Parameterangaben
40008	Das RPM-Anfragelimit für den Agenten wurde überschritten. Bitte wenden Sie sich an den Serviceanbieter, um das Limit zu erhöhen.
40127	Entwicklerauthentifizierung fehlgeschlagen
40353	Diese Funktion steht nur nach einem Upgrade Ihres Tarifs zur Verfügung.
403100	Ungültiger Tabellenname
403103	Ungültiger Feldname
50000	Interner Systemfehler. Bitte versuchen Sie es später erneut.