Statusabfrage zum Hinzufügen von Tabellendaten

Mit dieser API können Sie den Bearbeitungsstatus Ihrer Aufgaben zum Hinzufügen von Tabellendaten abfragen.

Anfragemethode

GET

Endpoint

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

Authentifizierung

Lesen Sie die Hinweise zur Authentifizierung im API-Überblick.

Anfrage

Beispielanfrage

curl -X GET 'https://api-${endpoint}/v1/database/query/import-results?ids=68ec7ad3e307920f002648cd' \ -H 'Authorization: Bearer ${API Key}'

                      
                      curl -X GET 'https://api-${endpoint}/v1/database/query/import-results?ids=68ec7ad3e307920f002648cd' \
-H 'Authorization: Bearer ${API Key}'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Verwenden Sie zur Authentifizierung den Header: Authorization: Bearer ${API Key}. Den API-Schlüssel erhalten Sie auf der API-Key-Seite.

Query-Parameter

Feld	Typ	Erforderlich	Beschreibung
ids	Liste	Ja	Liste der Aufgaben-IDs zum Hinzufügen von Daten.

Antwort

Beispielantwort

[ { "id": "68ec7ad3e307920f002648cd", "progress": 1, "status": "FAIL", "total_count": 4, "success_count": 0, "fail_count": 4, "fail_detail": [ { "row": null, "row_number_start": 1, "row_number_end": 2, "fail_reason": "(1062, \"Duplicate entry '14' for key 'product_feed_090833.id'\")" }, { "row": 2, "row_number_start": 0, "row_number_end": 0, "fail_reason": "`id` muss eindeutig sein, aber der Wert '14' ist doppelt vorhanden (erstmals in Zeile `1`)." }, { "row": 4, "row_number_start": 0, "row_number_end": 0, "fail_reason": "`no` ist erforderlich und muss einen Wert enthalten; der aktuelle Wert ist ungültig oder die Eigenschaft fehlt. `no` muss eindeutig sein, aber der Wert ist leer oder die Eigenschaft fehlt." } ] } ]

                      
                      [
    {
        "id": "68ec7ad3e307920f002648cd",
        "progress": 1,
        "status": "FAIL",
        "total_count": 4,
        "success_count": 0,
        "fail_count": 4,
        "fail_detail": [
            {
                "row": null,
                "row_number_start": 1,
                "row_number_end": 2,
                "fail_reason": "(1062, \"Duplicate entry '14' for key 'product_feed_090833.id'\")"
            },
            {
                "row": 2,
                "row_number_start": 0,
                "row_number_end": 0,
                "fail_reason": "`id` muss eindeutig sein, aber der Wert '14' ist doppelt vorhanden (erstmals in Zeile `1`)."
            },
            {
                "row": 4,
                "row_number_start": 0,
                "row_number_end": 0,
                "fail_reason": "`no` ist erforderlich und muss einen Wert enthalten; der aktuelle Wert ist ungültig oder die Eigenschaft fehlt. `no` muss eindeutig sein, aber der Wert ist leer oder die Eigenschaft fehlt."
            }
        ]
    }
]

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
id	string	Die eindeutige ID der Aufgabe.
progress	int	Fortschritt der Aufgabe in Prozent (1 bis 100).
status	string	Status der Aufgabe. `"FAIL"` bedeutet Fehler, `"PENDING_PARSE"` bedeutet, dass die Datei gerade analysiert wird, und `"AVAILABLE"` bedeutet, dass mindestens ein Datensatz erfolgreich hinzugefügt wurde.
total_count	int	Gesamtzahl der verarbeiteten Einträge.
success_count	int	Anzahl der erfolgreich verarbeiteten Einträge.
fail_count	int	Anzahl der fehlgeschlagenen Einträge.
fail_detail	Array<Object>	Positionen und Gründe für fehlgeschlagene Hinzufügungen.
row	int	Gibt die Zeilennummer an, in der der Fehler aufgetreten ist. Ist der Wert `null`, kann der Fehler keiner bestimmten Zeile zugeordnet werden.
row_number_start	int	Gibt den Beginn des Fehlerbereichs an (in Zehnerblöcken).
row_number_end	int	Gibt das Ende des Fehlerbereichs an (in Zehnerblöcken).
fail_reason	string	Beschreibung des Fehlergrundes.

Fehlgeschlagene Antwort

Feld	Typ	Beschreibung
code	int	Fehlercode.
message	string	Fehlerdetails.

Fehlercodes

Code	Nachricht
50000	Interner Systemfehler

Wie interpretiere ich die Antwort?

Fehlerfall beim Hinzufügen von Tabellendaten: Kollision mit bestehenden Daten

Fehlerfall 1: Wenn die importierten Daten mit bereits vorhandenen Daten in der Datentabelle kollidieren, wird kein Datensatz importiert.
- Der Wert von "fail_count" entspricht "total_count".
- "row" ist null.
- Prüfen Sie in diesem Fall den Wert von "fail_reason", um das Problem zu identifizieren.
- "row_number_start" und "row_number_end" stimmen möglicherweise nicht mit den tatsächlichen Zeilennummern überein und können ignoriert werden.
Fehlerfall 2: Gibt es einen Konflikt innerhalb der importierten Daten selbst, wird der erste Datensatz importiert, der zweite jedoch verworfen.
- "row" zeigt die Zeilennummer des zweiten, konfligierenden Eintrags.
- "row_number_start" und "row_number_end" sind 0.
Weitere Fehler: Entspricht ein importierter Datensatz nicht dem erforderlichen Format oder den Regeln, wird dieser Datensatz nicht importiert.
- "row" zeigt die Zeilennummer des ungültigen Eintrags.
- "row_number_start" und "row_number_end" sind 0.

Nutzen Sie diese Statusabfrage, um den Bearbeitungsstatus Ihrer Aufgaben zum Hinzufügen von Tabellendaten effizient zu überwachen und Fehlerquellen gezielt zu identifizieren.