logo
Entwicklung
Suchen
Tabellendaten hinzufügen

Tabellendaten hinzufügen

Mit dieser API können Sie in einem einzigen Vorgang bis zu 1.000 Datenzeilen zur angegebenen Datentabelle eines Agenten hinzufügen, um diese anschließend in Konversationen zu nutzen und abzufragen.

Hinweis:

  • Die Feldlänge bei aktiviertem unique darf 256 Zeichen nicht überschreiten.
  • Die Feldlänge ohne aktiviertes unique darf 4.294.967.295 Zeichen nicht überschreiten. Die tatsächliche Begrenzung erfolgt durch Netzwerkbedingungen; es wird empfohlen, die Datenlänge zu begrenzen.
  • Daten, die über die API übertragen werden, werden automatisch ins CSV-Format konvertiert. Maximale CSV-Dateigröße: 10 MB.

Anfragemethode

POST
HTTP-Methode

Endpoint

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

Authentifizierung

Informationen zur Authentifizierung finden Sie in der API-Übersicht.

Anfrage

Beispielanfrage

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

                    
Dieser Codeblock im schwebenden Fenster

Hinweis: Ersetzen Sie ${endpoint} und ${API Key} durch Ihre spezifischen Variablen.

Anfrage-Header

Feld Typ Beschreibung
Authorization Bearer ${API Key} Zur Authentifizierung verwenden Sie Authorization: Bearer ${API Key}. Den API Key finden Sie auf der API-Key-Seite.
Content-Type application/json Datentyp, auf application/json setzen.

Wichtig:

  • Wenn in der Datentabelle eindeutige Felder (unique fields) vorhanden sind, müssen alle eindeutigen Felder in den Datensätzen enthalten sein.
  • Werte für eindeutige Felder dürfen nicht doppelt vorkommen, nicht leer sein und nicht bereits in der Datenbank existieren, andernfalls tritt ein Fehler auf und die Daten werden verworfen.

Anfrage-Body

Feld Typ Erforderlich Beschreibung
records Liste Ja Liste der hinzuzufügenden Datensätze.
table_id String Ja ID der Tabelle.

Antwort

Beispielantwort

"673e9cda9f7bc178002dbd9c"
                      
                      "673e9cda9f7bc178002dbd9c"

                    
Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld Typ Beschreibung
code int Typcode der Nachricht.
message string Beschreibung der Nachricht.
data object Die Task-ID für diesen Tabellendaten-Hinzufüge-Vorgang. Es wird nur eine Task-ID zurückgegeben.

Fehlgeschlagene Antwort

Feld Typ Beschreibung
code int Fehlercode.
message string Detaillierte Fehlermeldung.

Fehlercodes

Code Nachricht
40000 Parameterfehler
50000 Interner Systemfehler