सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

इंटीग्रेशन

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

एक 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 स्थापना की आवश्यकता नहीं है।

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

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

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

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

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

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

एक बार आयात करें
flashdata auth login --profile research

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
खाता पढ़ें JSON
(
: "${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'
)

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

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

चेकआवश्यक परिणाम
Intended accountaccountId और 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 list

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

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

सर्वर जांचें
openclaw mcp doctor flashdata --probe

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

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

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

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

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

ताजा-प्रक्रिया एक्सेस चेक 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}'
)

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

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

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

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

कनेक्शनकहाँ रद्द करना
MCP OAuthSettings → 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 की जाँच करें; वैध कुंजी को प्रतिस्थापित न करें।
Markdown