Créer une table de base de données

Permet de créer de nouvelles tables de base de données et leurs champs pour l'agent via cette API.

Méthode de requête

POST

Endpoint

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

Authentification

Pour plus de détails, veuillez consulter la description de la méthode d'authentification dans la Vue d'ensemble de l'API.

Requête

Exemple de requête

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": "Tester toutes les API de base de données", "fields": [ { "name": "id", "description": "id", "type": "TEXT", "required": true, "unique": true }, { "name": "boolean", "description": "booléen", "type": "BOOLEAN", "required": true, "unique": false }, { "name": "int", "description": "entier", "type": "INT", "required": true, "unique": true }, { "name": "datetime", "description": "date et heure", "type": "DATETIME", "required": true, "unique": false }, { "name": "float", "description": "flottant", "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": "Tester toutes les API de base de données",
    "fields": [
        {
            "name": "id",
            "description": "id",
            "type": "TEXT",
            "required": true,
            "unique": true
        },
        {
            "name": "boolean",
            "description": "booléen",
            "type": "BOOLEAN",
            "required": true,
            "unique": false
        },
        {
            "name": "int",
            "description": "entier",
            "type": "INT",
            "required": true,
            "unique": true
        },
        {
            "name": "datetime",
            "description": "date et heure",
            "type": "DATETIME",
            "required": true,
            "unique": false
        },
        {
            "name": "float",
            "description": "flottant",
            "type": "FLOAT",
            "required": false,
            "unique": false
        }
    ]
}'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Bearer ${API Key}	Utilisez Authorization: Bearer ${API Key} pour l'authentification. Obtenez la clé API depuis la page Clé API.
Content-Type	application/json	Type de données, à définir sur application/json.

Paramètres de la requête

Champ	Type	Obligatoire	Description
name	string	Oui	Nom de la table : 64 caractères, lettres a~z/chiffres et underscores, commence par une lettre.
description	string	Oui	Description de la table : 128 caractères, pour aider l'IA à comprendre la structure des données de la table.
fields	array	Oui	Tableau des champs de la table.
fields[].name	string	Oui	Nom du champ : 64 caractères, lettres a~z/chiffres et underscores.
fields[].description	string	Oui	Description du champ : 128 caractères, pour aider l'IA à comprendre la structure des données du champ.
fields[].type	string	Oui	Type de données : TEXT/INT/FLOAT/DATETIME/BOOLEAN.
fields[].required	boolean	Non	Obligatoire : true/false.
fields[].unique	boolean	Non	Unique : true/false.

Réponse

Exemple de réponse

"673e9c7a9f7bc178002dbce8"

                      
                      "673e9c7a9f7bc178002dbce8"

Ce bloc de code dans la fenêtre flottante

Réponse en cas de succès

Champ	Type	Description
code	int	Code du type de message.
message	string	Description du message.
data	object	Contenu de la réponse, identifiant unique de la table.

Réponse en cas d'échec

Champ	Type	Description
code	int	Code d'erreur.
message	string	Détails de l'erreur.

Codes d'erreur

Code	Message
40000	Paramètres invalides
40008	Limite de requêtes RPM de l'agent dépassée. Veuillez contacter le fournisseur de service pour augmenter la limite.
40127	Échec de l'authentification du développeur
40353	Cette fonctionnalité est disponible uniquement après la mise à niveau de votre offre
403100	Nom de table invalide
403103	Nom de champ invalide
50000	Erreur interne du système