# API क्विकस्टार्ट

Google Search और YouTube APIs को सीधे HTTP पर कॉल करें। एक अनुरोध भेजें और JSON प्रतिक्रिया पढ़ें; कोई SDK की आवश्यकता नहीं है।

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

<a id="application"></a>

## अपना पहला HTTP अनुरोध बनाएं

अपने API कुंजी सेट करें, एक Google खोज भेजें और सहेजे गए प्रतिक्रिया का निरीक्षण करें।


<a id="prepare"></a>

### प्रमाणीकरण

एक खाता बनाएं, अपने ईमेल को सत्यापित करें और Google Search अनुमति के साथ एक कुंजी बनाएं। आप मौजूदा कुंजी का पुन: उपयोग कर सकते हैं।

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

#### Bash

##### कुंजी सेट करें

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


#### PowerShell 7

##### कुंजी सेट करें

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


- [खाता बनाएँ](https://flashdata.dev/signup)
- [API Keys खोलें](https://flashdata.dev/app/api-keys)
- [एजेंट प्रमाणीकरण](https://flashdata.dev/auth.md)

<a id="curl"></a>

### खोज चलाएँ

एक ग्राहक चुनें और उसी टर्मिनल में उदाहरण चलाएं। प्रत्येक एक भेजता है POST अनुरोध करना https://data.flashdata.dev/v1/queries/realtime और प्रिंट JSON. X-API-Key के साथ प्रमाणीकरण करें; JSON को Content-Type के साथ भेजें: application/json.

#### cURL

cURL 7.76+· Bash on Linux, macOS या Git Bash. पेस्ट करें और चलाएं।

##### खोज · Bash / cURL

```bash
curl --fail-with-body --silent --show-error --max-time 70 \
  --request POST https://data.flashdata.dev/v1/queries/realtime \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}'
```


#### PowerShell 7

PowerShell 7+ · इस देशी PowerShell कमांड को पेस्ट करें।

##### खोज · PowerShell

```powershell
$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
$flashdataSearch = @{
  Uri = 'https://data.flashdata.dev/v1/queries/realtime'
  Method = 'Post'
  Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  ContentType = 'application/json'
  Body = $flashdataRequest
  TimeoutSec = 70
  MaximumRedirection = 0
  SkipHttpErrorCheck = $true
  ErrorAction = 'Stop'
}
$flashdataResponse = Invoke-WebRequest @flashdataSearch
$flashdataResponse.Content
if ($flashdataResponse.StatusCode -ge 400) {
  throw "HTTP $($flashdataResponse.StatusCode). Inspect the response above before retrying."
}
```


#### JavaScript

Node.js 22+ · search.mjs के रूप में सहेजें और स्थानीय रूप से या अपने सर्वर पर चलाएं। निर्मित में लाने का उपयोग करता है; कोई npm स्थापित नहीं है।

##### search.mjs

```javascript
const key = process.env.FLASHDATA_API_KEY;
if (!key) throw new Error("Set FLASHDATA_API_KEY in this terminal.");

let response;
try {
  response = await fetch("https://data.flashdata.dev/v1/queries/realtime", {
    method: "POST",
    redirect: "error",
    signal: AbortSignal.timeout(70000),
    headers: { "X-API-Key": key, "Content-Type": "application/json" },
    body: JSON.stringify({"source":"google_search","query":"battery recycling research","params":{"num":5}}),
  });
} catch {
  throw new Error("Request did not complete. Check History before resubmitting.");
}

const body = await response.text();
console.log(body); // Print the full response before checking its status.
if (!response.ok) {
  const retryAfter = response.headers.get("retry-after");
  throw new Error("HTTP " + response.status + ". See the response above." +
    (retryAfter ? " Retry-After: " + retryAfter : ""));
}
let result;
try {
  result = JSON.parse(body);
} catch {
  throw new Error("Expected JSON. Inspect the response above and the API URL.");
}
if (!result || result.error === true || result.status !== "done" || !Array.isArray(result.results)) {
  throw new Error("Query did not succeed. Inspect status and error in the response above.");
}
```

##### Run · JavaScript

```bash
node search.mjs
```


#### Python

Python 3.10+ · search.py के रूप में सहेजें। केवल मानक पुस्तकालय का उपयोग करता है; कोई pip स्थापित नहीं है। यदि वह आपका Python कमांड है तो python3 या py-3 का उपयोग करें।

##### search.py

```python
import json
import os
import urllib.error
import urllib.request

key = os.environ.get("FLASHDATA_API_KEY")
if not key:
    raise SystemExit("Set FLASHDATA_API_KEY in this terminal.")

# Do not forward the API key to a redirect destination.
class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

request = urllib.request.Request(
    "https://data.flashdata.dev/v1/queries/realtime",
    data=json.dumps({"source":"google_search","query":"battery recycling research","params":{"num":5}}).encode("utf-8"),
    headers={"X-API-Key": key, "Content-Type": "application/json"},
    method="POST",
)
try:
    with urllib.request.build_opener(NoRedirect).open(request, timeout=70) as response:
        body = response.read().decode("utf-8")
except urllib.error.HTTPError as error:
    print(error.read().decode("utf-8", errors="replace"))
    retry_after = error.headers.get("Retry-After")
    raise SystemExit("HTTP " + str(error.code) + ". See the response above." +
                     (" Retry-After: " + retry_after if retry_after else ""))
except (urllib.error.URLError, TimeoutError):
    raise SystemExit("Request did not complete. Check History before resubmitting.")

print(body)  # The run command saves this full response to result.json.
try:
    result = json.loads(body)
except json.JSONDecodeError:
    raise SystemExit("Expected JSON. Inspect the response above and the API URL.")
if (not isinstance(result, dict) or result.get("error") is True
        or result.get("status") != "done" or not isinstance(result.get("results"), list)):
    raise SystemExit("Query did not succeed. Inspect status and error in the response above.")
```

##### Run · Python

```bash
python -X utf8 search.py
```



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

### परिणाम जाँचें

HTTP सफलता और status: done की पुष्टि करें। results[].organic में स्रोत शीर्षक, लिंक और स्निपेट्स पढ़ें, और usage.credits में चार्ज करें।

status: done के साथ एक खाली परिणाम या कार्बनिक सूची एक वैध खाली परिणाम है।

| फील्ड | इसके लिए उपयोग करें |
| --- | --- |
| status | "done" क्वेरी सफलतापूर्वक समाप्त होने की पुष्टि करता है। |
| results[0].organic[] | परिणाम खोजें। जांचें कि परिणाम अनुक्रमण से पहले कोई भी समस्या नहीं है। |
| title / link / snippet | स्रोत शीर्षक, URL और अंश। |
| usage.credits | इस प्रश्न के लिए वास्तविक क्रेडिट का शुल्क लिया गया है। |

#### उदाहरण

```json
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```


<a id="diagnostics"></a>

## डिबगिंग के लिए प्रतिक्रिया सहेजें

अगले अनुरोध पर कब्जा करने के लिए, इन विकल्पों को ऊपर cURL कमांड में जोड़ें। असफल अनुरोध को पुनः प्राप्त करने की निर्णय लेने से पहले फ़ाइलों का निरीक्षण करें।

### cURL

```bash
--dump-header response-headers.txt --output result.json
```

- [HTTP त्रुटियों और वसूली](https://flashdata.dev/hi/docs/errors/reference.md)

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

## पहुँच और क्रेडिट की जाँच करें

इन GET अनुरोधों ने क्वेरी क्रेडिट का उपयोग किए बिना पहचान, संतुलन और मूल्य निर्धारण को पढ़ा। HTTP 200 को Expect करें और भुगतान किए गए कार्य को जमा करने से पहले नीचे दिए गए फ़ील्ड को चेक करें।

खाता पढ़ता है: https://api.flashdata.dev/v2. डेटा अनुरोध: https://data.flashdata.dev/v1. दोनों X-API-Key का उपयोग करते हैं; JSON POST अनुरोध भी Content-Type का उपयोग करें: application/json.

| पढ़िए | प्रतिक्रिया में क्या जांच करें |
| --- | --- |
| identity | इरादा accountId, access: "ready", "google_search" युक्त दायरे और किसी भी expiresAt की पुष्टि करें। accountType एक मालिक कुंजी या "temporary" के लिए "owned" है। |
| balance | पढ़िए availableCredits. इस खाते के लिए सभी कुंजी समान शेष राशि का उपयोग करती है। |
| pricing | कीमतों के लिए [0], पुष्टि स्रोत google_search है और उपलब्ध true है। requestCount के लिए estimatedCredits की तुलना करें: 1 के साथ availableCredits मूल्य और शेष राशि जमा करने से पहले बदल सकते हैं। |

### Bash / cURL

#### नि: शुल्क चेक · Bash

```bash
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
  printf '\n%s\n' "$endpoint"
  curl --fail-with-body --silent --show-error --max-time 20 \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --write-out '\nHTTP %{http_code}\n' \
    "https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)
```


### PowerShell 7

#### नि: शुल्क चेक · PowerShell

```powershell
try {
  foreach ($flashdataPath in @('identity', 'balance', 'pricing?source=google_search&request_count=1')) {
    Write-Host $flashdataPath
    $flashdataRead = @{
      Uri = "https://api.flashdata.dev/v2/api-access/$flashdataPath"
      Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
      TimeoutSec = 20
      MaximumRedirection = 0
      ErrorAction = 'Stop'
    }
    Invoke-RestMethod @flashdataRead | ConvertTo-Json -Depth 20
  }
} catch {
  throw
}
```



<a id="next"></a>

## अगला कदम

- [Google Search सर्वोत्तम प्रथाओं](https://flashdata.dev/hi/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/hi/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/hi/docs/guides/youtube-download-guide/reference.md)
- [API संदर्भ](https://flashdata.dev/hi/docs/api-reference/reference.md)
- [OpenAPI विनिर्देश](https://flashdata.dev/docs/openapi.json)

<a id="troubleshooting"></a>

## यदि कोई कदम विफल हो जाता है

अपने टर्मिनल में मुद्रित प्रतिक्रिया पढ़ें। JavaScript और Python की रिपोर्ट HTTP त्रुटियों और Retry-After को stderr को। प्रत्येक उदाहरण एक बार प्रस्तुत करता है; यह स्वचालित रूप से पुनः प्रयास नहीं करता है।

| लक्षण | अगली कार्रवाई |
| --- | --- |
| कमान लापता या असमर्थित विकल्प | चयनित उदाहरण में आवश्यक संस्करण की जाँच करें। उपयोग PowerShell 7 बजाय Windows PowerShell 5.1, या उपयोग Bash साथ cURL 7.76+. JavaScript को नोड 22+ की आवश्यकता है; Python को 3.10+ की जरूरत है। अपने आधिकारिक डाउनलोड पृष्ठ से लापता रनटाइम स्थापित करें, टर्मिनल को फिर से खोलने के बाद फिर से कुंजी सेट करें। |
| मिसिंग कुंजी / 401 | इस प्रक्रिया में FLASHDATA_API_KEY सेट करें और फिर पहचान की जांच करें। पूर्ण सक्रिय API कुंजी की आपूर्ति, बिना बियरर उपसर्ग के। यदि यह समाप्त हो गया है या रद्द कर दिया गया है, तो वर्तमान अधिकृत क्रेडेंशियल का उपयोग करें; इसे चैट में पेस्ट न करें। |
| 403 | google_search के लिए identity.scopes की जाँच करें और तैयार करने के लिए उपयोग करें। मालिक से लापता अनुमति का अनुरोध करें; अनुरोध में स्रोत को बदलने से एक्सेस नहीं मिलती है। |
| 402 | फिर से संतुलन पढ़ें और इसे वर्तमान मूल्य के साथ तुलना करें। मालिक Billing की समीक्षा कर सकता है। एक थकावट परीक्षण को दावा करने के माध्यम से मालिक की पहुंच की आवश्यकता होती है; प्रतिस्थापन परीक्षण बनाना वसूली नहीं है। |
| 400 / 422 | लौटे त्रुटि संदेश पढ़ें। सटीक डेटा होस्ट, POST विधि, Content-Type और JSON फ़ील्ड नामों की जाँच करें। सीधे उद्धरण और एक संख्यात्मक params.num का उपयोग करें, फिर अस्वीकार किए गए अनुरोध को सही करें। |
| 429 | यदि उपस्थित हो तो Retry-After का सम्मान करें; अन्यथा एक बाध्य बैकऑफ़ का उपयोग करें और सहमति को कम करें। तेजी से लूप न करें, नई कुंजी बनाएं या सीमा को बायपास करने के लिए एक अन्य परीक्षण दर्ज करें। |
| HTTP 200 असफल स्थिति या त्रुटि के साथ | शरीर में त्रुटि को पढ़ें और किसी भी अनुरोध या नौकरी को संरक्षित करें ID. एक सफल कार्य के रूप में एक parsed JSON बॉडी का इलाज न करें या इसे स्वचालित रूप से दोहराएं। |
| खाली परिणाम | यदि स्थिति की जाती है, तो प्रमाणीकरण कार्य करता है। खाली परिणाम रखें या एक नए भुगतान अनुरोध के रूप में एक व्यापक क्वेरी की कोशिश करें। |
| JSON के बजाय टाइमआउट, कनेक्शन हानि, 5xx या HTML | एक POST को स्वीकार किया जा सकता है, भले ही इसकी प्रतिक्रिया खो गई हो। मूल क्वेरी के लिए History की जाँच करें और किसी भी लौटाने वाले IDs की रक्षा करें। नि: शुल्क GET चेक को पुनः प्राप्त किया जा सकता है। की पुष्टि करें URL data.flashdata.dev का उपयोग करता है, वेबसाइट होस्ट नहीं करता है, और TLS सत्यापन को अक्षम नहीं करता है। |

- [अनुरोध इतिहास](https://flashdata.dev/app/jobs)
- [कुंजी प्रबंधित करें](https://flashdata.dev/app/api-keys)
- [cURL डाउनलोड](https://curl.se/download.html)
- [स्थापित करें PowerShell](https://learn.microsoft.com/powershell/scripting/install/installing-powershell)
- [Node.js डाउनलोड](https://nodejs.org/en/download)
- [Python डाउनलोड](https://www.python.org/downloads/)
