Nutzung nach API-Key abrufen

Gibt nach API-Key gruppierte Nutzungsstatistiken zurück. Erfordert einen Admin-API-Key.

GEThttps://api.deutschlandgpt.de/v2/admin/usage/by-api-key

Beispielaufruf

curl https://api.deutschlandgpt.de/v2/admin/usage/by-api-key \
  -X GET \
  -H "Authorization: Bearer $DGPT_API_KEY"

curl https://api.deutschlandgpt.de/v2/admin/usage/by-api-key \
  -X GET \
  -H "Authorization: Bearer $DGPT_API_KEY"

import os, requests

response = requests.get(
    "https://api.deutschlandgpt.de/v2/admin/usage/by-api-key",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)

print(response.json())

import os, requests

response = requests.get(
    "https://api.deutschlandgpt.de/v2/admin/usage/by-api-key",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/admin/usage/by-api-key', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
  },
});

console.log(await response.json());

const response = await fetch('https://api.deutschlandgpt.de/v2/admin/usage/by-api-key', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
  },
});

console.log(await response.json());

Parameter

start_datestring<date>optional

Startdatum (ISO 8601). Standard: vor 30 Tagen.

end_datestring<date>optional

Enddatum (ISO 8601). Standard: heute.

anonymizebooleanoptional

Wenn true (Standard), werden personenbezogene Felder durch deterministische SHA-256-Hashes ersetzt. Auf false setzen, um Rohwerte zurückzugeben.

Antwort

200application/json

{
  "object": "list",
  "data": [
    {
      "apiKeyId": "string",
      "apiKeyName": "string",
      "totalCost": 0,
      "requestCount": 0
    }
  ]
}

{
  "object": "list",
  "data": [
    {
      "apiKeyId": "string",
      "apiKeyName": "string",
      "totalCost": 0,
      "requestCount": 0
    }
  ]
}

Nutzung nach API-Key

objectstring

dataUsageByApiKey[]

apiKeyIdstring

apiKeyNamestring

Name des API-Keys. Standardmäßig SHA-256-gehasht, wenn anonymize=true.

totalCostnumber

Gesamtkosten. Wert in Mikro-Cent (durch 100,000,000 dividieren für EUR).

requestCountinteger

Statuscodes

200

Nutzung nach API-Key

object

401

Nicht autorisiert

403

Erfordert Admin-API-Key