# एजेंट प्रमाणीकरण विकल्प

एक API कुंजी या MCP OAuth के साथ कनेक्ट करें, बिना किसी भुगतान क्वेरी के एक्सेस को सत्यापित करें, और बाद में कार्यों के लिए इसका पुन: उपयोग करें।

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

<a id="access"></a>

## 1. चुनें और कनेक्ट करें

पहले से ही जुड़े? सीधे कदम 2 में मुफ्त चेक पर जाएं। अन्यथा, अपने आवेदन या एजेंट की जरूरतों को पूरा करने का विकल्प चुनें।

| आप कनेक्ट हो रहे हैं | उपयोग | कौन क्रेडेंशियल रखता है? |
| --- | --- | --- |
| एक app, SDK, CLI या अनुसूचित स्क्रिप्ट | मालिक API कुंजी | आपका सर्वर का गुप्त स्टोर या CLI प्रोफाइल |
| Codex या OpenClaw अनुसंधान उपकरण | MCP OAuth | ब्राउज़र की सहमति के बाद मेजबान |
| एक एजेंट बिना किसी खाते के FlashData की कोशिश कर रहा है | अस्थायी API कुंजी | एजेंट की सहेजी गई परीक्षण प्रोफ़ाइल, फिर दावा करने के बाद मालिक पहुंच |

### API कुंजी

अपने कार्य की जरूरतों के स्रोतों के साथ API Keys में एक कुंजी बनाएं, या मौजूदा कुंजी का पुन: उपयोग करें। इसे अपने SDK में आपूर्ति करें या इसे अपने बैकएंड से X-API-Key के रूप में भेजें। Bash और PowerShell चरण 2 में सीधे API के साथ काम करते हैं; कोई CLI स्थापना की आवश्यकता नहीं है।

- [API Keys](https://flashdata.dev/app/api-keys)
- [CLI में एक कुंजी सहेजें](https://flashdata.dev/hi/docs/guides/agent-access/reference.md#import-key)
- [SDK और HTTP कुंजी सेटअप](https://flashdata.dev/hi/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

FlashData OAuth के लिए एक होस्ट का उपयोग करें। खाता मालिक ब्राउज़र में साइनअप या साइन-इन और सहमति को पूरा करता है; होस्ट टोकन बचाता है। यह कनेक्शन एक CLI कुंजी को स्थापित नहीं करता है या परीक्षण का दावा नहीं करता है।

#### MCP कनेक्शन की मेजबानी

```text
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:research
```

- [कनेक्ट Codex](https://flashdata.dev/hi/docs/integrations/codex/reference.md#setup)
- [कनेक्ट OpenClaw](https://flashdata.dev/hi/docs/integrations/openclaw/reference.md#setup)
- [अन्य MCP क्लाइंट](https://flashdata.dev/hi/docs/integrations/mcp-clients/reference.md#connect)

### एजेंट परीक्षण

एक कुंजी के बिना एक एजेंट के लिए, discover पंजीकरण करने से पहले वर्तमान परीक्षण योग्यता। एक मौजूदा परीक्षण और उसके प्रोफ़ाइल का पुन: उपयोग करें। YouTube Download और आवर्ती कार्यों को मालिक पहुँच की आवश्यकता होती है।

#### बिना पंजीकरण के खोज करें

```bash
flashdata discover --profile research --json
```

- [एक परीक्षण शुरू करें और दावा करें कि यह](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md)
- [एजेंट प्रमाणीकरण प्रोटोकॉल](https://flashdata.dev/auth.md)


<a id="permissions"></a>

### कौन से स्रोत इस क्रेडेंशियल का उपयोग कर सकते हैं?

सामान्य HTTP अनुरोधों और API-key MCP कनेक्शन के लिए X-API-Key का उपयोग करें। OAuth वाहक टोकन केवल होस्ट किए गए MCP समापन बिंदु पर काम करते हैं। YouTube Download को youtube_download और गंतव्य भंडारण के साथ एक मालिक API कुंजी की जरूरत है।

| क्रेज़ी | उपलब्ध स्रोत |
| --- | --- |
| मालिक API कुंजी | सूत्रों को अनुमति देने पर youtube_download सहित कुंजी को दिया गया। |
| अस्थायी API कुंजी | केवल परीक्षण योग्य स्रोतों को प्रदान किया गया। वर्तमान पहचान प्रतिक्रिया से गुंजाइश पढ़ें। |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


<a id="import-key"></a>

### CLI में एक कुंजी सहेजें

अगर आयात छोड़ें CLI पहले से ही एक्सेस या आपके गुप्त प्रबंधक की आपूर्ति है FLASHDATA_API_KEY. अन्यथा, नीचे एक विधि का चयन करें और बाद में आदेशों के लिए उसी शोध प्रोफ़ाइल को बनाए रखें। एक बचाया CLI कुंजी स्वचालित रूप से SDKs या स्थानीय MCP सर्वर पर उपलब्ध नहीं है।

#### इंटरेक्टिव टर्मिनल

छिपे हुए टर्मिनल प्रॉम्प्ट पर कुंजी पेस्ट करें।

##### एक बार आयात करें

```bash
flashdata auth login --profile research
```


#### स्वचालन · Bash

एक मौजूदा संरक्षित कुंजी फ़ाइल के रास्ते में FLASHDATA_KEY_FILE सेट करें। यह आदेश stdin के माध्यम से पढ़ता है; चैट और कमांड तर्कों से कुंजी को बाहर रखता है।

##### stdin के माध्यम से एक संरक्षित रहस्य पढ़ें

```bash
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
  < "$FLASHDATA_KEY_FILE"
```


- [CLI स्थापना](https://flashdata.dev/hi/docs/guides/flashdata-cli/reference.md#install)

<a id="verify"></a>

## 2. कनेक्शन सत्यापित करें

पर्यावरण में मुफ्त जांच चलाएं जो कार्य करेगा। CLI और HTTP चेक एक API कुंजी का उपयोग करते हैं; MCP चेक मेजबान के अपने बचाया कनेक्शन का उपयोग करता है।

### 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
}
```


### CLI

लॉगिन से OS उपयोगकर्ता, प्रोफ़ाइल और राज्य निर्देशिका का उपयोग करें। यदि आप किसी अन्य प्रोफ़ाइल का उपयोग करते हैं तो अनुसंधान बदलें; यदि आवश्यक हो तो --state-dir PATH जोड़ें। FLASHDATA_API_KEY बचाया कुंजी overrides। ok: true और data.accessVerified: true का अन्वेषण करें; फिर नीचे दिए गए पहचान क्षेत्रों का निरीक्षण करें।

#### फ्री खाता पढ़ता

```bash
flashdata auth status --profile research --json --non-interactive
```

- [एक कुंजी सेट करें](https://flashdata.dev/hi/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

इसे अपने कनेक्टेड एजेंट के एक नए सत्र में भेजें। अपने कार्य की जरूरतों के स्रोत के साथ google_search बदलें। दोनों टूल कॉल को सफल होने की उम्मीद करते हैं; भुगतान किए गए काम से पहले अलग से मूल्य निर्धारण और शेष राशि की जांच करें। केवल एक सूचीबद्ध सर्वर पहुँच को सत्यापित नहीं करता है।

#### कनेक्शन की जांच

```text
मौजूदा flashdata MCP कनेक्शन का उपयोग करें।
{"source":"google_search","request_count":1} के साथ get_pricing को कॉल करें।
{} के साथ get_balance को कॉल करें।
रिपोर्ट करें कि क्या दोनों कॉल सफल हुए हैं, क्या स्रोत में एक उपलब्ध कीमत है, क्या है?
और उपलब्ध क्रेडिट शेष राशि। शून्य शेष एक प्रमाणीकरण विफलता नहीं है।
एक खोज या डाउनलोड न करें, परीक्षण करें, या क्रेडेंशियल बदलें।
```



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

### API कुंजी पहचान पढ़ें

HTTP पहचान क्षेत्र शीर्ष स्तर पर हैं। CLI JSON में, data.identity.identity को पढ़ा और data.accessVerified: true की आवश्यकता है। HTTP 200 या CLI ok: true अकेले पर्याप्त नहीं है।

| चेक | आवश्यक परिणाम |
| --- | --- |
| Intended account | accountId और apiKeyId उस खाते और कुंजी की पहचान करता है जिसका आप उपयोग करना चाहते हैं। |
| उपयोग | access: ready |
| कार्य अनुमति | गुंजाइश में स्रोत होता है, जैसे कि google_search। CLI भी data.identity.permittedSources में अनुमत स्रोतों को सूचीबद्ध करता है। |
| आवर्ती कार्य | accountType: owned · installed: true · recurringAllowed: true |

- [शेड्यूल करने से पहले इन चेकों को स्वचालित करें](https://flashdata.dev/hi/docs/guides/agent-access/reference.md#recurring-check)

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

### एक सक्रिय परीक्षण एक वैध कनेक्शन है

एक परीक्षण एक बंद कार्य जांच पारित कर सकते हैं जबकि recurringAllowed false है। वास्तविक गुंजाइश और समाप्ति पढ़ें; शेड्यूलिंग कार्य से पहले मौजूदा परीक्षण का दावा करें।

#### अस्थाई पहचान · उदाहरणात्मक क्षेत्र

```json
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}
```


<a id="codex"></a>

### Codex में कनेक्शन खोजें

सूचीबद्ध सर्वर, फिर एक ताजा Codex सत्र में /mcp का उपयोग करते हैं। क्रेडेंशियल को सत्यापित करने के लिए ऊपर MCP जाँच करें।

#### सूची सर्वर

```bash
codex mcp list
```

- [Codex सेटअप और पहला कार्य](https://flashdata.dev/hi/docs/integrations/codex/reference.md)

<a id="openclaw"></a>

### OpenClaw में कनेक्शन की जांच करें

सेव्ड सर्वर को जांचें, फिर अपने सक्रिय वार्तालाप में ऊपर MCP चेक करें।

#### सर्वर जांचें

```bash
openclaw mcp doctor flashdata --probe
```

- [OpenClaw सेटअप और पहला कार्य](https://flashdata.dev/hi/docs/integrations/openclaw/reference.md)

<a id="refresh"></a>

## 3. बाद के कार्यों के लिए उपयोग

क्रेडेंशियल स्टोर को निजी और लगातार प्रक्रिया रीस्टार्ट में रखें। अपने शेड्यूलर को सक्षम करने से पहले एक नई प्रक्रिया में पहुंच की जांच करें।

| क्रेज़ी | अगले कार्य के लिए |
| --- | --- |
| मालिक API कुंजी | बचाया कुंजी का उपयोग करें। इसमें कोई OAuth रीफ्रेश स्टेप नहीं है; इसे तब बदलें जब समाप्त हो गया हो या रद्द हो गया हो। |
| MCP OAuth | मेजबान एक घंटे OAuth पहुँच टोकनों को घूमते हुए रिफ्रेश टोकनों का उपयोग करते हुए ताज़ा करता है। जब 90-day अनुदान समाप्त हो जाता है या रद्द कर दिया जाता है तो फिर से कनेक्ट करें। प्रत्येक स्थापना अपने टोकन स्टोर का मालिक है; मेजबानों के बीच ताज़ा टोकन फ़ाइलों को साझा न करें। |
| अस्थायी API कुंजी | मालिक को काम करने से पहले दावा करने और क्रेडेंशियल हैंडऑफ़ को समाप्त करना। मूल प्रोफ़ाइल का पुन: उपयोग करें; प्रत्येक रन के लिए फिर से पंजीकरण न करें। |

- [आवर्ती कार्यप्रवाह](https://flashdata.dev/hi/docs/guides/recurring-tasks/reference.md)

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

### शेड्यूल करने से पहले CLI कार्य की जांच करें

Bash और jq की आवश्यकता है। SOURCE को कार्य के स्रोत पर सेट करें। स्क्रिप्ट डिफ़ॉल्ट रूप से अनुसंधान का उपयोग करती है; एक अलग प्रोफ़ाइल या राज्य निर्देशिका के लिए FLASHDATA_PROFILE और FLASHDATA_STATE_DIR सेट करें। एक्सिट 0 पहचान के साथ JSON का मतलब है कि मालिक कुंजी इस स्रोत के लिए तैयार, स्थापित और अनुमत है। अपने शेड्यूलर को किसी भी अन्य निकास पर रोक दिया है। कोई प्रश्न प्रस्तुत नहीं किया जाता है।

#### ताजा-प्रक्रिया एक्सेस चेक Bash

```bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)
```

- [मूल्य निर्धारण, संतुलन और एक आवर्ती धावक जोड़ें](https://flashdata.dev/hi/docs/guides/recurring-tasks/reference.md#prepare)

<a id="claim"></a>

### यदि आप अभी भी एक परीक्षण कर रहे हैं

मूल प्रोफाइल के साथ परीक्षण और दावा करने की मार्गदर्शिका पूरी करें। मालिक की मंजूरी और क्रेडेंशियल हैंडऑफ़ के बाद, मुफ्त चेक को स्वामित्व वाली पहुंच और recurringAllowed: true दिखाना चाहिए। जारी अनुरोध मालिक के साझा संतुलन का उपयोग करते हैं; अप्रयुक्त परीक्षण क्रेडिट स्थानांतरण नहीं करते हैं। MCP OAuth लॉगिन एक अलग कनेक्शन है और इस परीक्षण का दावा नहीं करता है।

- [परीक्षण और दावा आदेश](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

<a id="revoke"></a>

## पहुँच रद्द करें

पहली बार फिर से चल रही नौकरियों का भुगतान करें। नीचे दिए गए मिलान क्रेडेंशियल को रद्द करें, फिर स्थानीय पहुंच को साफ़ करने से पहले एक ताजा प्रक्रिया या सत्र से मुफ्त चेक को दोहराएं। प्रमाणीकरण विफलता या फिर से कनेक्ट करने के अनुरोध की उम्मीद; जांच के दौरान एक नए कनेक्शन को मंजूरी नहीं दी जाती है। अकेले स्थानीय लॉगआउट सर्वर एक्सेस को रद्द नहीं करता है।

| कनेक्शन | कहाँ रद्द करना |
| --- | --- |
| MCP OAuth | Settings → Connected apps → the app's अनुदान. |
| दावा एजेंट API कुंजी | Settings → Connected apps → एजेंट कनेक्शन। |
| खाता API कुंजी | API Keys → इस एकीकरण द्वारा उपयोग की जाने वाली कुंजी। |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [समस्या निवारण पहुँच त्रुटियों](https://flashdata.dev/hi/docs/guides/troubleshooting/reference.md#credentials)

<a id="fixes"></a>

## असफल जाँच को ठीक करें

| परिणाम | कार्रवाई |
| --- | --- |
| accessVerified: false | चरण और nextCommand पढ़ें। एक लंबित प्रोफ़ाइल एक कुंजी प्रयोग करने योग्य होने से पहले ok: true लौटा सकती है। इसके सहेजे गए पंजीकरण या दावा को समाप्त करें; उसी प्रोफाइल को बनाए रखें। |
| access: blocked | यहां तक कि अगर HTTP उत्तर 200 था बंद करो। कंसोल में खाता या कनेक्शन की समीक्षा करें; क्वेरी की अनुमति के रूप में पहचान प्रतिक्रिया का इलाज नहीं करें। |
| accountType: temporary | एक-बंद कार्य के लिए पात्र परीक्षण का उपयोग करें। इसे शेड्यूल करने से पहले दावा करें; एक नया OAuth कनेक्शन इस प्रोफ़ाइल का दावा नहीं करता है। |
| installed: false | मालिक की मंजूरी के बाद, मूल प्रोफाइल और राज्य निर्देशिका के साथ flashdata auth finish --wait चलाएं। फिर चेक दोहराएं। |
| 401 / invalid_grant | अपने मूल होस्ट में समय-समय पर क्रेडेंशियल को फिर से कनेक्ट करें या रद्द करें। इसे बायपास करने के लिए एक और परीक्षण शुरू न करें। |
| 403 / source_forbidden | कुंजी के दायरे या OAuth स्रोत सूची की जाँच करें। YouTube Download एक मालिक API कुंजी का उपयोग करता है। |
| मान्य पहुँच, शून्य संतुलन | प्रमाणीकरण ने काम किया। भुगतान किए गए काम से पहले Billing की जाँच करें; वैध कुंजी को प्रतिस्थापित न करें। |

- [Billing](https://flashdata.dev/app/billing)
- [एक बाधित कनेक्शन को पुनर्प्राप्त करें](https://flashdata.dev/hi/docs/guides/agent-recovery/reference.md)
