दस्तावेज़ देखें
इंटीग्रेशन
एक API कुंजी या MCP OAuth के साथ कनेक्ट करें, बिना किसी भुगतान क्वेरी के एक्सेस को सत्यापित करें, और बाद में कार्यों के लिए इसका पुन: उपयोग करें।
इस पेज पर
1. चुनें और कनेक्ट करें
पहले से ही जुड़े? सीधे कदम 2 में मुफ्त चेक पर जाएं। अन्यथा, अपने आवेदन या एजेंट की जरूरतों को पूरा करने का विकल्प चुनें।
| आप कनेक्ट हो रहे हैं | उपयोग | कौन क्रेडेंशियल रखता है? |
|---|---|---|
| एक app, SDK, CLI या अनुसूचित स्क्रिप्ट | मालिक API कुंजी | आपका सर्वर का गुप्त स्टोर या CLI प्रोफाइल |
| Codex या OpenClaw अनुसंधान उपकरण | MCP OAuth | ब्राउज़र की सहमति के बाद मेजबान |
| एक एजेंट बिना किसी खाते के FlashData की कोशिश कर रहा है | अस्थायी API कुंजी | एजेंट की सहेजी गई परीक्षण प्रोफ़ाइल, फिर दावा करने के बाद मालिक पहुंच |
अपने कार्य की जरूरतों के स्रोतों के साथ API Keys में एक कुंजी बनाएं, या मौजूदा कुंजी का पुन: उपयोग करें। इसे अपने SDK में आपूर्ति करें या इसे अपने बैकएंड से X-API-Key के रूप में भेजें। Bash और PowerShell चरण 2 में सीधे API के साथ काम करते हैं; कोई CLI स्थापना की आवश्यकता नहीं है।
FlashData OAuth के लिए एक होस्ट का उपयोग करें। खाता मालिक ब्राउज़र में साइनअप या साइन-इन और सहमति को पूरा करता है; होस्ट टोकन बचाता है। यह कनेक्शन एक CLI कुंजी को स्थापित नहीं करता है या परीक्षण का दावा नहीं करता है।
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchएक कुंजी के बिना एक एजेंट के लिए, discover पंजीकरण करने से पहले वर्तमान परीक्षण योग्यता। एक मौजूदा परीक्षण और उसके प्रोफ़ाइल का पुन: उपयोग करें। YouTube Download और आवर्ती कार्यों को मालिक पहुँच की आवश्यकता होती है।
flashdata discover --profile research --jsonकौन से स्रोत इस क्रेडेंशियल का उपयोग कर सकते हैं?
सामान्य 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 |
CLI में एक कुंजी सहेजें
अगर आयात छोड़ें CLI पहले से ही एक्सेस या आपके गुप्त प्रबंधक की आपूर्ति है FLASHDATA_API_KEY. अन्यथा, नीचे एक विधि का चयन करें और बाद में आदेशों के लिए उसी शोध प्रोफ़ाइल को बनाए रखें। एक बचाया CLI कुंजी स्वचालित रूप से SDKs या स्थानीय MCP सर्वर पर उपलब्ध नहीं है।
छिपे हुए टर्मिनल प्रॉम्प्ट पर कुंजी पेस्ट करें।
flashdata auth login --profile researchएक मौजूदा संरक्षित कुंजी फ़ाइल के रास्ते में FLASHDATA_KEY_FILE सेट करें। यह आदेश stdin के माध्यम से पढ़ता है; चैट और कमांड तर्कों से कुंजी को बाहर रखता है।
: "${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"2. कनेक्शन सत्यापित करें
पर्यावरण में मुफ्त जांच चलाएं जो कार्य करेगा। CLI और HTTP चेक एक API कुंजी का उपयोग करते हैं; MCP चेक मेजबान के अपने बचाया कनेक्शन का उपयोग करता है।
Bash और cURL 7.76+ की आवश्यकता है। यदि आपका पर्यावरण पहले से ही FLASHDATA_API_KEY की आपूर्ति करता है तो छिपे हुए कुंजी प्रॉम्प्ट को छोड़ दें। उसी टर्मिनल में पढ़ने वाले कमांड को चलाएं।
# 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(
: "${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'
)यदि FLASHDATA_API_KEY पहले से ही सेट किया गया है तो छिपे हुए कुंजी प्रॉम्प्ट को छोड़ दें। उसी टर्मिनल में पढ़ने वाले कमांड को चलाएं।
# 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& {
$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
}लॉगिन से OS उपयोगकर्ता, प्रोफ़ाइल और राज्य निर्देशिका का उपयोग करें। यदि आप किसी अन्य प्रोफ़ाइल का उपयोग करते हैं तो अनुसंधान बदलें; यदि आवश्यक हो तो --state-dir PATH जोड़ें। FLASHDATA_API_KEY बचाया कुंजी overrides। ok: true और data.accessVerified: true का अन्वेषण करें; फिर नीचे दिए गए पहचान क्षेत्रों का निरीक्षण करें।
flashdata auth status --profile research --json --non-interactiveइसे अपने कनेक्टेड एजेंट के एक नए सत्र में भेजें। अपने कार्य की जरूरतों के स्रोत के साथ google_search बदलें। दोनों टूल कॉल को सफल होने की उम्मीद करते हैं; भुगतान किए गए काम से पहले अलग से मूल्य निर्धारण और शेष राशि की जांच करें। केवल एक सूचीबद्ध सर्वर पहुँच को सत्यापित नहीं करता है।
मौजूदा flashdata MCP कनेक्शन का उपयोग करें।
{"source":"google_search","request_count":1} के साथ get_pricing को कॉल करें।
{} के साथ get_balance को कॉल करें।
रिपोर्ट करें कि क्या दोनों कॉल सफल हुए हैं, क्या स्रोत में एक उपलब्ध कीमत है, क्या है?
और उपलब्ध क्रेडिट शेष राशि। शून्य शेष एक प्रमाणीकरण विफलता नहीं है।
एक खोज या डाउनलोड न करें, परीक्षण करें, या क्रेडेंशियल बदलें।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 |
एक सक्रिय परीक्षण एक वैध कनेक्शन है
एक परीक्षण एक बंद कार्य जांच पारित कर सकते हैं जबकि recurringAllowed false है। वास्तविक गुंजाइश और समाप्ति पढ़ें; शेड्यूलिंग कार्य से पहले मौजूदा परीक्षण का दावा करें।
{
"accountType": "temporary",
"access": "ready",
"installed": false,
"recurringAllowed": false,
"scopes": [
"google_search"
]
}Codex में कनेक्शन खोजें
सूचीबद्ध सर्वर, फिर एक ताजा Codex सत्र में /mcp का उपयोग करते हैं। क्रेडेंशियल को सत्यापित करने के लिए ऊपर MCP जाँच करें।
codex mcp listOpenClaw में कनेक्शन की जांच करें
सेव्ड सर्वर को जांचें, फिर अपने सक्रिय वार्तालाप में ऊपर MCP चेक करें।
openclaw mcp doctor flashdata --probe3. बाद के कार्यों के लिए उपयोग
क्रेडेंशियल स्टोर को निजी और लगातार प्रक्रिया रीस्टार्ट में रखें। अपने शेड्यूलर को सक्षम करने से पहले एक नई प्रक्रिया में पहुंच की जांच करें।
| क्रेज़ी | अगले कार्य के लिए |
|---|---|
| मालिक API कुंजी | बचाया कुंजी का उपयोग करें। इसमें कोई OAuth रीफ्रेश स्टेप नहीं है; इसे तब बदलें जब समाप्त हो गया हो या रद्द हो गया हो। |
| MCP OAuth | मेजबान एक घंटे OAuth पहुँच टोकनों को घूमते हुए रिफ्रेश टोकनों का उपयोग करते हुए ताज़ा करता है। जब 90-day अनुदान समाप्त हो जाता है या रद्द कर दिया जाता है तो फिर से कनेक्ट करें। प्रत्येक स्थापना अपने टोकन स्टोर का मालिक है; मेजबानों के बीच ताज़ा टोकन फ़ाइलों को साझा न करें। |
| अस्थायी API कुंजी | मालिक को काम करने से पहले दावा करने और क्रेडेंशियल हैंडऑफ़ को समाप्त करना। मूल प्रोफ़ाइल का पुन: उपयोग करें; प्रत्येक रन के लिए फिर से पंजीकरण न करें। |
शेड्यूल करने से पहले CLI कार्य की जांच करें
Bash और jq की आवश्यकता है। SOURCE को कार्य के स्रोत पर सेट करें। स्क्रिप्ट डिफ़ॉल्ट रूप से अनुसंधान का उपयोग करती है; एक अलग प्रोफ़ाइल या राज्य निर्देशिका के लिए FLASHDATA_PROFILE और FLASHDATA_STATE_DIR सेट करें। एक्सिट 0 पहचान के साथ JSON का मतलब है कि मालिक कुंजी इस स्रोत के लिए तैयार, स्थापित और अनुमत है। अपने शेड्यूलर को किसी भी अन्य निकास पर रोक दिया है। कोई प्रश्न प्रस्तुत नहीं किया जाता है।
(
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}'
)यदि आप अभी भी एक परीक्षण कर रहे हैं
मूल प्रोफाइल के साथ परीक्षण और दावा करने की मार्गदर्शिका पूरी करें। मालिक की मंजूरी और क्रेडेंशियल हैंडऑफ़ के बाद, मुफ्त चेक को स्वामित्व वाली पहुंच और recurringAllowed: true दिखाना चाहिए। जारी अनुरोध मालिक के साझा संतुलन का उपयोग करते हैं; अप्रयुक्त परीक्षण क्रेडिट स्थानांतरण नहीं करते हैं। MCP OAuth लॉगिन एक अलग कनेक्शन है और इस परीक्षण का दावा नहीं करता है।
पहुँच रद्द करें
पहली बार फिर से चल रही नौकरियों का भुगतान करें। नीचे दिए गए मिलान क्रेडेंशियल को रद्द करें, फिर स्थानीय पहुंच को साफ़ करने से पहले एक ताजा प्रक्रिया या सत्र से मुफ्त चेक को दोहराएं। प्रमाणीकरण विफलता या फिर से कनेक्ट करने के अनुरोध की उम्मीद; जांच के दौरान एक नए कनेक्शन को मंजूरी नहीं दी जाती है। अकेले स्थानीय लॉगआउट सर्वर एक्सेस को रद्द नहीं करता है।
| कनेक्शन | कहाँ रद्द करना |
|---|---|
| MCP OAuth | Settings → Connected apps → the app's अनुदान. |
| दावा एजेंट API कुंजी | Settings → Connected apps → एजेंट कनेक्शन। |
| खाता API कुंजी | API Keys → इस एकीकरण द्वारा उपयोग की जाने वाली कुंजी। |
असफल जाँच को ठीक करें
| परिणाम | कार्रवाई |
|---|---|
| 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 की जाँच करें; वैध कुंजी को प्रतिस्थापित न करें। |