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

शुरू करें

TypeScript & JavaScript SDK

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

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

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

    इंस्टॉल करें
    npm init -y
    npm install --save-exact @flashdata-dev/[email protected]
  2. प्रमाणीकरण

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

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

    छिपे हुए कुंजी संकेत 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
  3. खोज चलाएँ

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

    quickstart.mts
    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+
    node quickstart.mts
  4. परिणाम जाँचें

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

    उदाहरण
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search शीर्षक, लिंक और स्निपेट्स। अन्य स्रोतों में अपना खुद का टाइपिंग पेलोड होता है।
    usage.credits
    इस अनुरोध के लिए शुल्क लिया गया क्रेडिट; पांच वापसी हिट एक खोज अनुरोध है।

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

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

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

quickstart.mts / quickstart.mjs
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);

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

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

वैकल्पिक प्रकार की जांच
npm install --save-dev typescript@~5.9.3 @types/node@^22
npx tsc quickstart.mts --module nodenext --target es2022 --strict --noEmit

क्या 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 ऑब्जेक्ट डिफ़ॉल्ट हैं।

अगला कदम

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

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