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
uniquedarf 256 Zeichen nicht überschreiten.- Die Feldlänge ohne aktiviertes
uniquedarf 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 |
