# ऑथेंटिकेशन

> API keys से अपनी API requests ऑथेंटिकेट करें

- पेज: https://tbit.app/hi/docs/api/authentication
- Base URL: `https://rest-api.tbit.app/v1`
- ऑथेंटिकेशन: हर request में आपकी key के साथ `X-API-Key` header (उदाहरण इसे `TBIT_API_KEY` environment variable से पढ़ते हैं)

## परिचय

TBit API ऑथेंटिकेशन के लिए API keys का इस्तेमाल करती है। हर request में अपनी API key X-API-Key header में भेजें।

## अपनी API key पाएँ

अपनी API key देखने के लिए TBit डैशबोर्ड में Settings > API पर जाएँ। हर एजेंट की अपनी अलग API key होती है।

## इस्तेमाल

हर request में X-API-Key header भेजें:

`GET /v1/activities`

```bash
curl "https://rest-api.tbit.app/v1/activities" \
  -H "X-API-Key: $TBIT_API_KEY"
```

## सुरक्षा के सबसे अच्छे तरीके

- अपनी API key को कभी भी client-side कोड या पब्लिक repositories में न डालें
- अपनी API key environment variables में रखें
- अगर लगे कि API key लीक हो गई है, तो उसे रोटेट करें
- API requests सिर्फ़ HTTPS पर करें

## कैटलॉग endpoints के लिए publishable इस्तेमाल

अपवाद: कैटलॉग पढ़ने वाले endpoints (प्रोडक्ट, कैटेगरी, कार्ट) के लिए API key एक publishable key की तरह काम करती है: यह आपके अकाउंट की पहचान करती है और इस्तेमाल मापती है, और कैटलॉग का डेटा पब्लिक है। इन endpoints के लिए इसे ब्राउज़र कोड से इस्तेमाल करना सुरक्षित है, बिल्कुल Stripe की publishable key की तरह।

## ऑथेंटिकेशन एरर

| स्टेटस | कोड | विवरण |
| --- | --- | --- |
| `401` | `UNAUTHORIZED` | Missing or invalid API key |
| `429` | `RATE_LIMITED` | Rate limit exceeded (100 req/min) |