# TypeScript & JavaScript SDK

SDK स्थापित करें और Node.js में एक खोज चलाएं। TypeScript या JavaScript चुनें; सर्वर पर API कुंजी रखें।

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

- [GitHub](https://github.com/flashdatadev/flashdata-typescript) — स्रोत और SDK संदर्भ
- [API कुंजी लें](https://flashdata.dev/app/api-keys) — कंसोल में एक कुंजी बनाएं

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

## अपना पहला Node.js अनुरोध बनाएं

पैकेज स्थापित करें, अपनी API कुंजी सेट करें और नीचे TypeScript या JavaScript चुनें। इस कोड को अपने सर्वर पर या स्थानीय स्क्रिप्ट में चलाएं।

- [SDK विधि संदर्भ](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)
- [npm](https://www.npmjs.com/package/@flashdata-dev/sdk/v/1.1.0)

<a id="install"></a>

### SDK स्थापित करें

ये उदाहरण सीधे TypeScript चलाने के लिए Node.js 22.18+ का उपयोग करते हैं। यदि आपके पास package.json है, तो एक खाली फ़ोल्डर में शुरू करें या मौजूदा परियोजना का चयन करें।

#### नई परियोजना

##### इंस्टॉल करें

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```


#### मौजूदा परियोजना

##### इंस्टॉल करें

```bash
npm install --save-exact @flashdata-dev/sdk@1.1.0
```


- [स्थापित करें Node.js](https://nodejs.org/en/download)

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

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

Google Search अनुमति के साथ एक कुंजी बनाएं या अधिकृत कुंजी का पुन: उपयोग करें। इस टर्मिनल में FLASHDATA_API_KEY सेट करें, नीचे छिपे हुए प्रॉम्प्ट का उपयोग करें; इसे छोड़ दें यदि आपका वातावरण पहले से ही इसकी आपूर्ति करता है।

उदाहरण स्पष्ट रूप से कुंजी गुजरता है। इन लिपियों द्वारा फ़ाइल को लोड नहीं किया जाता है। वेब एप्लिकेशन में एकीकृत होने पर सर्वर-साइड कॉन्फ़िगरेशन में कुंजी रखें।

#### Bash

##### छिपे हुए कुंजी संकेत 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
# 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)
- [ओपन Billing](https://flashdata.dev/app/billing)
- [एजेंट परीक्षण सेटअप](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md)

<a id="query"></a>

### खोज चलाएँ

चयनित फ़ाइल को सहेजें और इस परियोजना में अपना आदेश चलाएं। प्रत्येक रन में पांच परिणाम तक की खोज की जाती है। दोनों फाइलें सीधे Node.js के साथ चलती हैं; इस उदाहरण के लिए कोई बिल्ड स्टेप की आवश्यकता नहीं है।

#### TypeScript

##### quickstart.mts

```typescript
import { FlashData, type GoogleSearchParams } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY in the server environment.');
const client = new FlashData({ apiKey });
const params: GoogleSearchParams = { num: 5 };
const response = await client.google.search({ query: 'battery recycling research', ...params });
if (response.status !== 'done') throw new Error(JSON.stringify(response));

for (const page of response.results) {
  for (const hit of page.organic ?? []) console.log(hit.title, hit.link);
}
console.log('Credits used:', response.usage.credits);
```

##### Run · Node.js 22.18+

```bash
node quickstart.mts
```


#### JavaScript

##### quickstart.mjs

```javascript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY in the server environment.');
const client = new FlashData({ apiKey });
const response = await client.google.search({ query: 'battery recycling research', num: 5 });
if (response.status !== 'done') throw new Error(JSON.stringify(response));

for (const page of response.results) {
  for (const hit of page.organic ?? []) console.log(hit.title, hit.link);
}
console.log('Credits used:', response.usage.credits);
```

##### चलाएँ

```bash
node quickstart.mjs
```



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

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

स्क्रिप्ट चेक स्टेटस किया जाता है और प्रिंट स्रोत शीर्षक, URLs और क्रेडिट का इस्तेमाल किया जाता है। खाली कार्बनिक परिणाम मान्य हैं। उदाहरण के लिए, नीचे आउटपुट आकृति को दिखाता है; लाइव स्रोतों में भिन्नता होगी।

| फील्ड | उपयोग |
| --- | --- |
| results[].organic[] | Google Search शीर्षक, लिंक और स्निपेट्स। अन्य स्रोतों में अपना खुद का टाइपिंग पेलोड होता है। |
| usage.credits | इस अनुरोध के लिए शुल्क लिया गया क्रेडिट; पांच वापसी हिट एक खोज अनुरोध है। |

#### उदाहरण

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


<a id="common-tasks"></a>

## एक और डेटा स्रोत आज़माएं

प्रत्येक टैब TypeScript और JavaScript दोनों में काम करता है। फ़ाइल को चरण 3 से बदलें, इसके .mts या .mjs एक्सटेंशन को रखें और उसी कमांड को चलाएं। प्रत्येक रन एक नया अनुरोध है और इसे दिखाया गया स्रोत अनुमति की आवश्यकता होती है।

### Google समाचार

google_news की आवश्यकता है। results[].news[] में लेख प्रविष्टियों को पढ़ें।

#### quickstart.mts / quickstart.mjs

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.news({
  query: 'battery recycling', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);
```


### YouTube मेटाडाटा

youtube_metadata की आवश्यकता है। रिटर्न्स शीर्षक, चैनल, अवधि और अन्य वीडियो विवरण।

#### quickstart.mts / quickstart.mjs

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.youtube.metadata({
  video_id: 'dQw4w9WgXcQ', include_formats: false,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);
```


### YouTube ट्रांसक्रिप्ट

youtube_transcript की आवश्यकता है। एक मौजूदा अंग्रेजी स्वचालित ट्रैक का अनुरोध करता है। जब ट्रैक उपलब्ध है तो टेक्स्ट results[].fullText में है।

#### quickstart.mts / quickstart.mjs

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.youtube.transcript({
  video_id: 'dQw4w9WgXcQ', language: 'en', auto: true,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);
```


- [सभी स्रोत पैरामीटर](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/sources/index.md)

<a id="typecheck"></a>

## टाइप-चेक एक TypeScript परियोजना

नोड इस उदाहरण को स्ट्रिपिंग प्रकार से चलाता है। एक अनुरोध भेजने के बिना प्रकार की जांच करने के लिए, TypeScript स्थापित करें और --noEmit के साथ कम्पाइलर चलाएं:

### वैकल्पिक प्रकार की जांच

```bash
npm install --save-dev typescript@~5.9.3 @types/node@^22
npx tsc quickstart.mts --module nodenext --target es2022 --strict --noEmit
```

- [Node.js TypeScript समर्थन](https://nodejs.org/api/typescript.html)

<a id="features"></a>

## क्या SDK समर्थन करता है

| उपयोग | विधियाँ |
| --- | --- |
| google / youtube | टाइप्ड सोर्स सहायकों के साथ संरचित डेटा को खोजें और पुनर्प्राप्त करें। अपनी सेवा में एक ग्राहक का पुन: उपयोग करें। |
| youtube.download | पृष्ठभूमि नौकरी के माध्यम से अपने क्लाउड स्टोरेज में ऑडियो या वीडियो को डिलीवर करें। youtube_download अनुमति और भंडारण विन्यास की आवश्यकता है। |
| jobs / bulk | जमा नौकरी IDs सेव करें और पूरा परिणाम प्राप्त करें। JavaScript में प्रतीक्षा करें; mode: 'async' सर्वर-साइड पृष्ठभूमि नौकरी जमा करता है। |
| account | आवर्ती कार्य से पहले पहुंच, संतुलन, मूल्य निर्धारण, सीमा और उपयोग पढ़ें। |
| respondWith / accept | पास { respondWith: 'markdown' } विधि के लिए दूसरा तर्क के रूप में Markdown में response.content, या { accept: 'text/plain' } एक स्ट्रिंग के लिए। JSON ऑब्जेक्ट डिफ़ॉल्ट हैं। |

- [उदाहरण डाउनलोड करें](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/examples/youtube_download.mjs)
- [भंडारण सेटअप](https://flashdata.dev/hi/docs/guides/youtube-download-guide/reference.md)
- [जवाब के फ़ॉर्मैट](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/response-formats.md)

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

## अगला कदम

- [परिणाम सहेजें और त्रुटियों को संभालने](https://flashdata.dev/hi/docs/guides/sdk-operations/reference.md)
- [नौकरियां और बैच](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/jobs.md)
- [ग्राहक विन्यास](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/client.md)
- [SDK विधि संदर्भ](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

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

| समस्या | फिक्स |
| --- | --- |
| पैकेज या रनटाइम लापता | नोड --version की जाँच करें और इस परियोजना में @flashdata-dev/sdk स्थापित करें। ऊपर दिखाए गए .mts या .mjs एक्सटेंशन को रखें। |
| 401 / FLASHDATA_API_KEY | टर्मिनल में एक वैध कुंजी सेट करें जहां आप उदाहरण चलाते हैं। |
| 403 | इस API कुंजी के लिए Google Search सक्षम करें। |
| 402 | उपलब्ध क्रेडिट के लिए Billing की जाँच करें, या एक थका हुआ एजेंट परीक्षण का दावा करें। |
| 429 | Retry-After के लिए प्रतीक्षा करें, फिर अपनी अनुरोध दर को कम करें। |
| टाइमआउट या सर्वर त्रुटि | Resending से पहले History की जाँच करें; पहला अनुरोध पहले से ही चल सकता है। |

- [अनुरोध इतिहास](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [SDK त्रुटियों और वसूली](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/errors.md)
