Tabellen-Datensätze aktualisieren

Mit dieser API können Sie bis zu 100 ausgewählte Datensätze in Agent-Datenbanktabellen stapelweise aktualisieren.

Hinweis:
Die maximale Größe des gesamten JSON-Request-Bodys beträgt 5 MB.
Pro Anfrage können maximal 100 Datensätze aktualisiert werden.

Anfragemethode

POST

Anfrage-URL

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

Authentifizierung

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

Anfrage

Beispielanfrage

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

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

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Authentifizierung mit `Authorization: Bearer ${API Key}`. Ihren API-Schlüssel erhalten Sie auf der Seite API Keys.
Content-Type	application/json	Datenformat, muss application/json sein.

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
table_id	string	Ja	Tabellen-ID.
is_create	bool	Nein	Gibt an, ob ein neuer Datensatz erstellt werden soll, wenn der angegebene Ziel-Datensatz nicht existiert.
update_data	Liste	Ja	Die zu aktualisierenden Datensätze.
record_id	string	Nein	Entweder `record_id` oder `filter` muss angegeben werden. `record_id` wird empfohlen.
filter	Map	Nein	Benutzerdefinierte Filterbedingung. Muss ein Feld mit `"unique": true` enthalten. Nur ein Feld wird unterstützt.
updated_fields	Liste	Ja	Die zu aktualisierenden Felder.

Hinweis

Entweder record_id oder filter muss angegeben werden. Wenn beides übergeben wird, hat record_id Vorrang.

Standardwert für is_create ist false.

Wenn is_create nicht angegeben ist, wird kein neuer Datensatz automatisch erstellt.

Wenn is_create auf true gesetzt ist und der record_id oder filter des zu aktualisierenden Datensatzes in der Tabelle nicht existiert, wird der Datensatz automatisch erstellt.

Antwort

Beispielantwort

{ "totalCount": 4, "success_count": 2, "fail_count": 2, "fail_detail": [ { "upsert_data": { "record_id": "123456", "value": { "name": "test user", "email": "invalid_email" } }, "fail_reason": "Ungültiges E-Mail-Format" }, { "upsert_data": { "filter": { "id": "789" }, "value": { "name": "test user", "email": "invalid_email" } }, "fail_reason": "Ungültiges E-Mail-Format" } ] }

                      
                      {
    "totalCount": 4,
    "success_count": 2,
    "fail_count": 2,
    "fail_detail": [
        {
            "upsert_data": {
                "record_id": "123456",
                "value": {
                    "name": "test user",
                    "email": "invalid_email"
                }
            },
            "fail_reason": "Ungültiges E-Mail-Format"
        },
        {
            "upsert_data": {
                "filter": {
                    "id": "789"
                },
                "value": {
                    "name": "test user",
                    "email": "invalid_email"
                }
            },
            "fail_reason": "Ungültiges E-Mail-Format"
        }
    ]
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
totalCount	int	Gesamtanzahl der Datensätze in diesem Update-Vorgang
success_count	int	Anzahl erfolgreich aktualisierter Datensätze
fail_count	int	Anzahl fehlgeschlagener Aktualisierungen
fail_detail	Array	Detaillierte Informationen zu fehlgeschlagenen Aktualisierungen
upsert_data	Array	Anfragedaten für diese fehlgeschlagene Aktualisierung
fail_reason	Array	Grund für das Scheitern der Aktualisierung

Fehlerantwort

Feld	Typ	Beschreibung
code	int	Fehlercode
message	string	Fehlerbeschreibung

Fehlercodes

Code	Nachricht
40000	Ungültige Parameter
50000	Interner Systemfehler
403106	Tabelle nicht gefunden
403131	Keine Berechtigung für den Tabellenzugriff