Tabellendaten aktualisieren

Mit dieser Schnittstelle können Sie gezielt die Werte bestimmter Datensätze in der Agenten-Datentabelle aktualisieren. Nutzen Sie die Funktion, um Ihre Datenbank effizient und sicher auf dem neuesten Stand zu halten.

Anfragemethode

POST

Endpunkt

https://api-${endpoint}.gptbots.ai/v1/database/update/record

Authentifizierung

Details zu den Authentifizierungsmethoden finden Sie in der API-Übersicht.

Anfrage

Beispielanfrage

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/update/record' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "record_id": "123456", "filter": { "id": "789" }, "updated_fields": { "name": "99990", "age": "30" } }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/update/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
  "table_id": "673af861ed69656ac0895b07",
  "record_id": "123456",
  "filter": {
    "id": "789"
  },
  "updated_fields": {
    "name": "99990",
    "age": "30"
  }
}'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Verwenden Sie Authorization: Bearer ${API Key} zur Authentifizierung. Den API-Schlüssel erhalten Sie auf der API-Key-Seite.
Content-Type	application/json	Datentyp, Wert ist application/json.

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
table_id	string	Ja	Tabellen-ID.
record_id	string	Nein	Datensatz-ID oder Filterbedingung, eines von beiden wählen. Die Angabe der Datensatz-ID wird empfohlen.
filter	map	Nein	Benutzerdefinierte Filterbedingungen (müssen benutzerdefinierte, eindeutige Primärschlüsselfelder verwenden).
updated_fields	list	Ja	Zu aktualisierende Datenfelder.
is_add	boolean	Nein	Gibt an, ob ein neuer Datensatz hinzugefügt werden soll, falls der Ziel-Datensatz nicht existiert.

Antwort

Beispielantwort

{ "code": 0, "message": "OK" }

                      
                      {
    "code": 0,
    "message": "OK"
}

Dieser Codeblock im schwebenden Fenster

Erfolgsantwort

Feld	Typ	Beschreibung
code	int	Typcode der Nachricht.
message	string	Nachrichtenbeschreibung.
data	object	Antwortinhalt, enthält die eindeutige Kennung der Datentabelle.

Fehlerantwort

Feld	Typ	Beschreibung
code	int	Fehlercode.
message	string	Fehlerdetails.

Fehlercodes

Code	Nachricht
40000	Parameterfehler
50000	Interner Systemfehler
403106	Tabelle nicht gefunden
403131	Kein Zugriff auf die Datentabelle