# हेडर और प्रमाणीकरण

सही होस्ट और क्रेडेंशियल इस्तेमाल करें, फिर एक मुफ़्त अनुरोध से ऐक्सेस जाँचें।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/guides/headers-and-authentication
समीक्षित: 2026-11-04 द्वारा FlashData

<a id="requests"></a>

## बेस URLs

| उद्देश्य | बेस URL | प्रमाणीकरण |
| --- | --- | --- |
| डेटा क्वेरीज़ और जॉब | https://data.flashdata.dev/v1 | X-API-Key |
| पहचान, संतुलन, मूल्य निर्धारण, सीमा और उपयोग | https://api.flashdata.dev/v2 | X-API-Key |
| दूरस्थ MCP | https://data.flashdata.dev/mcp | होस्ट-प्रबंधित OAuth, या X-API-Key |


<a id="choose"></a>

## प्रमाणीकरण शीर्षलेख

REST अनुरोध एक परीक्षण या मालिक कुंजी के साथ X-API-Key का उपयोग करते हैं। Content-Type के साथ JSON निकायों को भेजें: application/json. CLI प्रोफाइल, SDK वातावरण और MCP कनेक्शन स्टोर अलग से क्रेडेंशियल।

### REST / API कुंजी

#### हेडर का अनुरोध

```http
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json
```


### MCP / OAuth

चलो MCP होस्ट को लॉगिन के माध्यम से इस टोकन को प्राप्त, स्टोर और रीफ्रेश करें। इसे केवल MCP समापन बिंदु पर उपयोग करें। इसके बजाय एक API कुंजी का उपयोग करके मेजबान X-API-Key भेजता है।

#### हैडर MCP होस्ट द्वारा प्रबंधित

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [API कुंजी लें](https://flashdata.dev/hi/docs/guides/api-keys-and-permissions/reference.md)
- [MCP से कनेक्ट करें](https://flashdata.dev/hi/docs/integrations/mcp-clients/reference.md)

<a id="check"></a>

## अपनी कुंजी सत्यापित करें

इसे अपने टर्मिनल में चलाएं। पहचान समापन बिंदु क्रेडिट खर्च किए बिना पहुंच की जाँच करता है। यदि FLASHDATA_API_KEY पहले से ही सेट किया गया है तो प्रमुख संकेत छोड़ दें।

### Bash / cURL

Bash और cURL 7.76+ की आवश्यकता है। यदि आपका पर्यावरण पहले से ही FLASHDATA_API_KEY की आपूर्ति करता है तो छिपे हुए कुंजी प्रॉम्प्ट को छोड़ दें। उसी टर्मिनल में पढ़ने वाले कमांड को चलाएं।

#### कुंजी सेट करें · पहले से ही कॉन्फ़िगर किया गया है, तो छोड़ें

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

#### खाता पढ़ें JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

यदि FLASHDATA_API_KEY पहले से ही सेट किया गया है तो छिपे हुए कुंजी प्रॉम्प्ट को छोड़ दें। उसी टर्मिनल में पढ़ने वाले कमांड को चलाएं।

#### कुंजी सेट करें · पहले से ही कॉन्फ़िगर किया गया है, तो छोड़ें

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

#### खाता पढ़ें JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```



<a id="result"></a>

### अपेक्षित प्रतिक्रिया

HTTP 200 का प्रयोग करें। इच्छित खाते, access: ready और अपने स्रोत को दायरे में देखें। एक अस्थायी कुंजी में accountType: temporary है; मालिक के काम के लिए recurringAllowed: true की आवश्यकता होती है।

#### मालिक पहचान · उदाहरणात्मक प्रतिक्रिया अंश

```json
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}
```

- [अपनी पहली API कॉल करें](https://flashdata.dev/hi/docs/guides/http-quickstart/reference.md#curl)

<a id="storage"></a>

## हस्ताक्षरित भंडारण URLs

परिणाम और अपलोड URLs में अपना प्राधिकरण शामिल है। X-API-Key, OAuth टोकन या ब्राउज़र कुकीज़ के बिना वापस लौटे URL का पालन करें।


<a id="errors"></a>

## समस्या निवारण प्रमाणीकरण

| जवाब | अगला कदम |
| --- | --- |
| 401 | इस वातावरण में कुंजी की जाँच करें, इसकी समाप्ति और पुनरुत्थान। वर्तमान API कुंजी का उपयोग करें, एक MCP टोकन या बियरर उपसर्ग नहीं। |
| 403 / स्रोत लापता | मालिक को इस कुंजी के लिए आवश्यक स्रोत देने के लिए पूछो। |
| इस मुफ्त पढ़ा पर 503 | बाद में पढ़ने की कोशिश करो। खाता की स्थिति सत्यापित नहीं की गई थी; यह सत्यापित नहीं किया गया कि भुगतान की गई क्वेरी तैयार है। |

