दस्तावेज़ देखें
शुरू करें
सही होस्ट और क्रेडेंशियल इस्तेमाल करें, फिर एक मुफ़्त अनुरोध से ऐक्सेस जाँचें।
इस पेज पर
बेस 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 |
प्रमाणीकरण शीर्षलेख
REST अनुरोध एक परीक्षण या मालिक कुंजी के साथ X-API-Key का उपयोग करते हैं। Content-Type के साथ JSON निकायों को भेजें: application/json. CLI प्रोफाइल, SDK वातावरण और MCP कनेक्शन स्टोर अलग से क्रेडेंशियल।
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/jsonचलो MCP होस्ट को लॉगिन के माध्यम से इस टोकन को प्राप्त, स्टोर और रीफ्रेश करें। इसे केवल MCP समापन बिंदु पर उपयोग करें। इसके बजाय एक API कुंजी का उपयोग करके मेजबान X-API-Key भेजता है।
Authorization: Bearer YOUR_MCP_ACCESS_TOKENअपनी कुंजी सत्यापित करें
इसे अपने टर्मिनल में चलाएं। पहचान समापन बिंदु क्रेडिट खर्च किए बिना पहुंच की जाँच करता है। यदि FLASHDATA_API_KEY पहले से ही सेट किया गया है तो प्रमुख संकेत छोड़ दें।
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
}अपेक्षित प्रतिक्रिया
HTTP 200 का प्रयोग करें। इच्छित खाते, access: ready और अपने स्रोत को दायरे में देखें। एक अस्थायी कुंजी में accountType: temporary है; मालिक के काम के लिए recurringAllowed: true की आवश्यकता होती है।
{
"accountId": "acc_example",
"apiKeyId": "key_example",
"accountType": "owned",
"access": "ready",
"scopes": [
"google_search"
],
"recurringAllowed": true
}हस्ताक्षरित भंडारण URLs
परिणाम और अपलोड URLs में अपना प्राधिकरण शामिल है। X-API-Key, OAuth टोकन या ब्राउज़र कुकीज़ के बिना वापस लौटे URL का पालन करें।
समस्या निवारण प्रमाणीकरण
| जवाब | अगला कदम |
|---|---|
| 401 | इस वातावरण में कुंजी की जाँच करें, इसकी समाप्ति और पुनरुत्थान। वर्तमान API कुंजी का उपयोग करें, एक MCP टोकन या बियरर उपसर्ग नहीं। |
| 403 / स्रोत लापता | मालिक को इस कुंजी के लिए आवश्यक स्रोत देने के लिए पूछो। |
| इस मुफ्त पढ़ा पर 503 | बाद में पढ़ने की कोशिश करो। खाता की स्थिति सत्यापित नहीं की गई थी; यह सत्यापित नहीं किया गया कि भुगतान की गई क्वेरी तैयार है। |