Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Ü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: 
{
  "error": "Error message describing what went wrong"
}

​
Häufige Fehler

​
Authentifizierungsfehler

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
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

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:
"selections": [
  {
    "field": "num_acceptances",
    "aggregation_function": "QUERY_AGGREGATION_SUM"
  }
]
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_DATA
  • QUERY_DATA_SOURCE_CHAT_DATA
  • QUERY_DATA_SOURCE_COMMAND_DATA
  • QUERY_DATA_SOURCE_PCW_DATA
Fehler: 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:
"selections": [
  {
    "field": "num_acceptances",
    "aggregation_function": "QUERY_AGGREGATION_SUM"
  },
  {
    "field": "num_lines_accepted",
    "aggregation_function": "QUERY_AGGREGATION_UNSPECIFIED"
  }
]
Gültig:
"selections": [
  {
    "field": "num_acceptances",
    "aggregation_function": "QUERY_AGGREGATION_SUM"
  },
  {
    "field": "num_lines_accepted",
    "aggregation_function": "QUERY_AGGREGATION_SUM"
  }
]

​
Fehler bei Feldern und Aggregationen

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.
Fehler: 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:
"aggregations": [
  {
    "field": "distinct_developer_days",
    "name": "distinct_developer_days"
  }
]
Gültig:
"aggregations": [
  {
    "field": "api_key",
    "name": "api_key"
  },
  {
    "field": "date",
    "name": "date"
  }
]
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

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
Fehler: invalid timestamp formatUrsache: Der Zeitstempel entspricht nicht dem korrekten RFC-3339-Format.Lösung: Verwenden Sie das korrekte Zeitstempelformat:
2023-01-01T00:00:00Z
Gültige Beispiele:
  • 2024-01-01T00:00:00Z
  • 2024-12-31T23:59:59Z
  • 2024-06-15T12:30:45Z
Fehler: 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:
{
  "group_name": "engineering",
  "emails": ["user@example.com"]
}
Gültig:
{
  "group_name": "engineering"
}
Oder:
{
  "emails": ["user@example.com", "user2@example.com"]
}

​
Ratenbegrenzung

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

​
1. Einfach anfangen

Beginnen Sie mit einfachen Abfragen und erhöhen Sie die Komplexität schrittweise: 
{
  "service_key": "your_key",
  "query_requests": [
    {
      "data_source": "QUERY_DATA_SOURCE_USER_DATA",
      "selections": [
        {
          "field": "num_acceptances",
          "aggregation_function": "QUERY_AGGREGATION_COUNT"
        }
      ]
    }
  ]
}

​
2. Feldnamen überprüfen

Überprüfen Sie die Feldnamen noch einmal anhand der Dokumentation zu Verfügbare Felder.

​
3. Kompatibilität von Aggregationen prüfen

Stellen Sie sicher, dass Ihre Aggregationsfunktionen mit den Feldtypen kompatibel sind, die Sie auswählen.

​
4. Filter einzeln testen

Wenn Ihre Abfrage nicht die erwarteten Ergebnisse liefert, versuchen Sie, die Filter nacheinander zu entfernen, um das Problem einzugrenzen.

​
5. 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:
  1. Prüfen Sie die Fehlermeldung sorgfältig - Die meisten Fehler enthalten konkrete Hinweise zur Behebung des Problems
  2. Überprüfen Sie die Beispiele - Vergleichen Sie die Struktur Ihrer Abfrage mit den funktionierenden Beispielen in der Dokumentation
  3. Kontaktieren Sie den Support - Wenden Sie sich mit Ihrer konkreten Fehlermeldung und Ihrer Abfrage an den Devin Desktop Support

​
Hinweise zur API-Version

Die Fehlerbehandlung und Validierung wurden ab API-Version 1.10.0 verbessert. Wenn Sie eine ältere Version verwenden, sollten Sie ein Update erwägen, um detailliertere Fehlermeldungen zu erhalten.