Management Key

API कुंजी की गतिविधि पाएं

चुनी गई अवधि में एक API कुंजी की गतिविधि के आंकड़े लौटाता है। period में day, week, month या year हो सकता है; सभी सीमाएँ UTC पर आधारित हैं: दिन 00:00 UTC, सप्ताह सोमवार 00:00 UTC, महीना पहले दिन 00:00 UTC और वर्ष 1 जनवरी 00:00 UTC से शुरू होता है। संगठन की Management Key से केवल उसी संगठन की कुंजियाँ पूछी जा सकती हैं। आंकड़े उस कुंजी के अपने खर्च, अनुरोध count, token count, model breakdown और time series के हैं, संगठन के कुल के नहीं; scope से बाहर की कुंजी 404 लौटाती है। CSV के लिए format=csv का उपयोग करें।

GET/v1/keys/:id/activity

प्राधिकरण

Authorizationआवश्यक

string · header

Authorization हेडर में bearer token के रूप में API कुंजी।

पथ पैरामीटर

idआवश्यक

string

उस API कुंजी का ID जिसकी गतिविधि लौटानी है।

क्वेरी पैरामीटर

period

string

आंकड़ों की अवधि। day, week, month और year UTC सीमाओं का उपयोग करते हैं; डिफ़ॉल्ट month है।

dayweekmonthyear

format

string

वैकल्पिक। csv रखने पर CSV export मिलता है; छोड़ने पर JSON लौटता है।

csv

GET /v1/keys/:id/activity

1
2
curl "https://api.bazaarlink.ai/v1/keys/key_demo_01/activity?period=month" \
  -H "Authorization: Bearer $BAZAARLINK_MANAGEMENT_KEY"

प्रतिक्रिया उदाहरण

सफल। totals में अवधि के लिए इस कुंजी का खर्च, अनुरोध count और token count होता है।

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "keyName": "worker-a",
  "period": "month",
  "since": "2026-09-01T00:00:00.000Z",
  "totals": {
    "spend": 9.37,
    "requests": 205,
    "tokens": 48200
  },
  "byModel": [
    {
      "model": "example-model",
      "spend": 9.37,
      "tokens": 48200,
      "requests": 205
    }
  ],
  "timeSeries": [
    {
      "date": "2026-09-30",
      "model": "example-model",
      "cost": 2.12,
      "tokens": 10400,
      "requests": 18
    }
  ]
}