Überblick
Die Analytics-API gibt detaillierte Fehlermeldungen zurück, um die Fehlersuche bei ungültigen Abfragen zu erleichtern. Auf dieser Seite werden häufige Fehlerszenarien und deren Behebung erläutert.Format von Fehlerantworten
Wenn ein Fehler auftritt, gibt die API eine Fehlerantwort mit einer aussagekräftigen Meldung zurück:Häufige Fehler
Authentifizierungsfehler
Ungültiger Service-Schlüssel
Ungültiger Service-Schlüssel
Fehler:
Invalid service keyUrsache: Der angegebene Service-Schlüssel ist ungültig oder wurde widerrufen.Lösung:- Vergewissern Sie sich, dass Ihr Service-Schlüssel korrekt ist
- Stellen Sie sicher, dass der Service-Schlüssel nicht widerrufen wurde
- Erstellen Sie bei Bedarf einen neuen Service-Schlüssel
Unzureichende Berechtigungen
Unzureichende Berechtigungen
Fehler:
Insufficient permissionsUrsache: Der Service-Schlüssel verfügt nicht über die erforderlichen Berechtigungen für den Endpunkt, den Sie aufrufen.Lösung:- Aktualisieren Sie die Berechtigungen des Service-Schlüssels in Team Settings
- Welche Berechtigung für den jeweiligen Endpunkt erforderlich ist, finden Sie in der API-Einführung
Fehler in der Abfragestruktur
Fehlende Auswahlfelder
Fehlende Auswahlfelder
Fehler:
at least one field or aggregation is requiredUrsache: Die Abfrageanfrage enthält keine Auswahlfelder oder Aggregationen.Lösung: Füge deiner Abfrageanfrage mindestens ein Auswahlfeld hinzu:Ungültige Datenquelle
Ungültige Datenquelle
Fehler:
invalid query table: QUERY_DATA_SOURCE_UNSPECIFIEDUrsache: Wahrscheinlich liegt ein Tippfehler im Feld data_source vor.Lösung: Überprüfe die Schreibweise deiner Datenquelle noch einmal. Gültige Optionen:QUERY_DATA_SOURCE_USER_DATAQUERY_DATA_SOURCE_CHAT_DATAQUERY_DATA_SOURCE_COMMAND_DATAQUERY_DATA_SOURCE_PCW_DATA
Gemischte Aggregationsfunktionen
Gemischte Aggregationsfunktionen
Fehler: Gültig:
all selection fields should have an aggregation function, or none of them shouldUrsache: Einige Auswahlfelder haben Aggregationsfunktionen, andere nicht.Lösung: Füge entweder allen Auswahlfeldern Aggregationsfunktionen hinzu oder entferne sie bei allen:Ungültig:Fehler bei Feldern und Aggregationen
Ungültige Aggregationsfunktion
Ungültige Aggregationsfunktion
Fehler:
invalid aggregation function for string type field ide: QUERY_AGGREGATION_SUMUrsache: Die Aggregationsfunktion wird für den angegebenen Feldtyp nicht unterstützt.Lösung: Im Abschnitt Verfügbare Felder sehen Sie, welche Aggregationsfunktionen für die einzelnen Felder gültig sind. String-Felder unterstützen in der Regel nur COUNT und UNSPECIFIED.Aggregation eines Distinct-Felds
Aggregation eines Distinct-Felds
Fehler: Gültig:
tried to aggregate on a distinct field: distinct_developer_days. Consider aggregating on the non-distinct fields instead: [api_key date]Ursache: Felder mit dem Muster „distinct_*“ können nicht im Abschnitt aggregations verwendet werden.Lösung: Verwenden Sie stattdessen die vorgeschlagenen alternativen Felder für die Aggregation:Ungültig:Doppelte Feldaliase
Doppelte Feldaliase
Fehler:
duplicate field alias for selection/aggregation: num_acceptancesUrsache: Mehrere Auswahlen oder Aggregationen haben denselben Namen.Lösung: Stellen Sie sicher, dass alle Feldaliase eindeutig sind. Beachten Sie, dass standardmäßig {aggregation_function}_{field_name} verwendet wird, wenn kein Name angegeben ist.Fehler bei der Datenfilterung
Ungültiger Gruppenname
Ungültiger Gruppenname
Fehler:
invalid group name: GroupNameUrsache: Der angegebene Gruppenname existiert in Ihrer Organisation nicht.Lösung:- Überprüfen Sie die Schreibweise des Gruppennamens
- Vergewissern Sie sich, dass die Gruppe in Ihren Team Settings vorhanden ist
- Verwenden Sie den Gruppennamen exakt so, wie er in Ihrem Team-Dashboard angezeigt wird
Ungültiges Zeitstempelformat
Ungültiges Zeitstempelformat
Fehler: Gültige Beispiele:
invalid timestamp formatUrsache: Der Zeitstempel entspricht nicht dem korrekten RFC-3339-Format.Lösung: Verwenden Sie das korrekte Zeitstempelformat:2024-01-01T00:00:00Z2024-12-31T23:59:59Z2024-06-15T12:30:45Z
Konfliktierende Filter
Konfliktierende Filter
Fehler: Gültig:Oder:
Cannot use both group_name and emails parametersUrsache: In einer Cascade-Analytics-Anfrage wurden sowohl die Parameter group_name als auch emails angegeben.Lösung: Verwenden Sie entweder group_name ODER emails, aber nicht beide zusammen:Ungültig:Ratenbegrenzung
Rate-Limit überschritten
Rate-Limit überschritten
Fehler:
429 Too Many RequestsUrsache: Sie haben das API-Rate-Limit überschritten.Lösung:- Warten Sie einen Moment, bevor Sie weitere Anfragen senden
- Implementieren Sie exponentielles Backoff in Ihrem Client
- Fassen Sie nach Möglichkeit mehrere Abfragen in einer einzelnen Anfrage zusammen
- Wenden Sie sich an den Support, wenn Sie ein höheres Rate-Limit benötigen
Tipps zum Debuggen
- Einfach anfangen
Beginnen Sie mit einfachen Abfragen und erhöhen Sie die Komplexität schrittweise:
- Feldnamen überprüfen
Überprüfen Sie die Feldnamen noch einmal anhand der Dokumentation zu Verfügbare Felder.
- Kompatibilität von Aggregationen prüfen
Stellen Sie sicher, dass Ihre Aggregationsfunktionen mit den Feldtypen kompatibel sind, die Sie auswählen.
- Filter einzeln testen
Wenn Ihre Abfrage nicht die erwarteten Ergebnisse liefert, versuchen Sie, die Filter nacheinander zu entfernen, um das Problem einzugrenzen.
- JSON korrekt formatieren
Stellen Sie sicher, dass Ihr JSON korrekt formatiert ist und alle Strings richtig in Anführungszeichen stehen.
Hilfe erhalten
Wenn weiterhin Probleme auftreten:- Prüfen Sie die Fehlermeldung sorgfältig - Die meisten Fehler enthalten konkrete Hinweise zur Behebung des Problems
- Überprüfen Sie die Beispiele - Vergleichen Sie die Struktur Ihrer Abfrage mit den funktionierenden Beispielen in der Dokumentation
- Kontaktieren Sie den Support - Wenden Sie sich mit Ihrer konkreten Fehlermeldung und Ihrer Abfrage an den Devin Desktop Support