Management Key

API कुंजियों की सूची

उन API कुंजियों की सूची देता है जिन्हें कॉल करने वाला प्रबंधित कर सकता है। संगठन की Management Key के साथ उत्तर में केवल उसी कुंजी के संगठन की कुंजियाँ आती हैं; मालिक की व्यक्तिगत कुंजियाँ या दूसरे संगठनों की कुंजियाँ कभी शामिल नहीं होतीं। सामान्य sk-bl- कुंजी इस management endpoint को नहीं बुला सकती; वेब डैशबोर्ड में लॉग-इन session cookie भी समर्थित है। प्रत्येक keys[] item में limit, limit_remaining, limit_reset, usage, usage_daily/weekly/monthly, requests, requests_daily/weekly/monthly और usage_scope: key होते हैं। ये मान उस कुंजी के साथ GET /v1/key के मानों से मेल खाते हैं। अलग सीमा होने पर limit_remaining रीसेट अवधि के खर्च को घटाने के बाद की सीमा है; अलग सीमा न होने पर यह उस कुंजी द्वारा उपयोग किया जाने वाला balance है। वास्तविक कुंजी secret कभी नहीं लौटाया जाता। संगठन का कुल और फिर हर कुंजी का उपयोग देखने के लिए GET /v1/key पृष्ठ का Management Key उदाहरण देखें।

GET/v1/keys

प्राधिकरण

Authorizationआवश्यक

string · header

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

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

orgId

string

Session cookie के साथ संगठन ID देकर उस संगठन की कुंजियाँ सूचीबद्ध की जा सकती हैं, यदि कॉल करने वाला वहाँ org_admin या billing_viewer है। संगठन की Management Key केवल अपने संगठन तक सीमित होती है और इस parameter से संगठन नहीं बदला जा सकता।

GET /v1/keys

1
2
curl https://api.bazaarlink.ai/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

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

सफल। keys[] नए से पुराने क्रम में है और हर कुंजी का metadata व उपयोग दिखाता है, वास्तविक secret नहीं।

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
28
29
30
31
32
33
34
35
{
  "keys": [
    {
      "id": "key_demo_01",
      "name": "worker-a",
      "keyPrefix": "demo_",
      "keySuffix": "01",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 73,
      "totalTokens": 48200,
      "lastUsed": "2026-09-30T02:14:00.000Z",
      "createdAt": "2026-09-01T00:00:00.000Z",
      "spendLimitUsd": 10,
      "spendLimitPeriod": "day",
      "limit": 10,
      "limit_remaining": 7.88,
      "limit_reset": "day",
      "usage": 24.41,
      "usage_daily": 2.12,
      "usage_weekly": 5.64,
      "usage_monthly": 9.37,
      "requests": 314,
      "requests_daily": 18,
      "requests_weekly": 61,
      "requests_monthly": 205,
      "usage_scope": "key",
      "allowedModels": null,
      "expiresAt": null,
      "organizationId": "org_demo_01",
      "teamId": null,
      "orgMemberId": null
    }
  ]
}