تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

البدء

API faststart

اتصل Google Search و YouTube APIs directly over HTTP. أرسلي طلباً واحداً وقرأي JSON الرد؛ لا SDK مطلوب.

  1. التوثيق

    إنشاء حساب، والتحقق من البريد الإلكتروني الخاص بك وخلق مفتاح مع Google Search إذن. يمكنك إعادة استخدام المفتاح الحالي.

    شغّل الأمر في الطرفية والصق المفتاح عند مطالبة الإدخال المخفي. تجاوز هذه الخطوة إذا كان 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
  2. نفّذ بحثًا

    اختر زبوناً و اضرب المثل في نفس المحطة ويرسل كل منها طلباً واحداً من طراز POST إلى https://data.flashdata.dev/v1/queries/realtime وطبعات من طراز JSON. Authenticate with X-API-Key; send JSON with Content-Type: application/json.

    cURL 7.76+ · Bash على Linux أو macOS أو Git Bash. الصق وشغّل.

    / / Bash / cURL
    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
      }
    }'
  3. تحقق من النتيجة

    تأكد من نجاح HTTP ووجود status: done. اقرأ عناوين المصادر وروابطها ومقتطفاتها في results[].organic والتكلفة في usage.credits.

    وتشكل النتائج الفارغة أو القائمة العضوية مع status: done نتيجة فارغة صالحة.

    الاستجابة على سبيل المثال
    {
      "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
      }
    }
    status
    "done" يؤكد أن الإستفسار انتهى بنجاح.
    results[0].organic[]
    نتائج البحث. تحقق من أن النتائج غير فارغة قبل فهرسة لها.
    title / link / snippet
    المصدر: URL و excerpt.
    usage.credits
    المبالغ الفعلية المقيدة على هذا الاستفسار.

أنقذوا ردّاً على التشويه

ولتلبية الطلب التالي المعتزم، تضاف هذه الخيارات إلى قيادة cURL أعلاه. فحص الملفات قبل أن يقرر إعادة النظر في طلب فاشل

cURL
--dump-header response-headers.txt --output result.json

الوصول إلى السجلات والائتمانات

وتُقرأ هذه الطلبات التي تقدمت بها شركة GET تحت عنوان " الهوية والتوازن والتسعير " دون استخدام ائتمانات الاستفسارات. التوقعات HTTP 200 وتحقق من الحقول الواردة أدناه قبل تقديم العمل المدفوع الأجر.

قراءات الحساب: https://api.flashdata.dev/v2. طلبات البيانات: https://data.flashdata.dev/v1. يستخدم كلاهما X-API-Key؛ وتستخدم طلبات JSON POST أيضًا Content-Type: application/json.

فحوص مجانية؛ 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
)
identity
تحقق من accountId المقصود وaccess: "ready" واحتواء scopes على "google_search"، ومن أي قيمة expiresAt. تكون accountType هي "owned" لمفتاح المالك أو "temporary" لمفتاح التجربة.
balance
إقرأْ availableCredits. جميع مفاتيح هذا الحساب تستخدم نفس التوازن
pricing
For prices[0], confirm source is google_search and available is true. Compare estimatedCredits for requestCount: 1 with availableCredits. ويمكن أن تتغير الأسعار والأرصدة قبل التقديم.

الخطوات التالية

إذا فشلت خطوة

اقرأ الاستجابة المطبوعة في الطرفية. تعرض JavaScript وPython أخطاء HTTP وRetry-After على stderr. يرسل كل مثال مرة واحدة؛ ولا يعيد المحاولة تلقائيًا.

خيار القيادة المفقود أو غير المدعوم
تحقق من النسخة المطلوبة في المثال المختار. الاستخدام PowerShell 7 بدلاً من Windows PowerShell 5.1أو استخدام Bash مع cURL 7.76+. JavaScript needs Node 22+; Python needs 3.10+. ضعوا الوقت المفقود من موقع تحميلها الرسمي، وأعيدوا فتح المحطة، ثم أعدوا المفتاح مرة أخرى.
مفتاح مفقود/ 401
المجموعة FLASHDATA_API_KEY في هذه العملية وتحقق من الهوية مرة أخرى توفير كامل النشاط API مفتاح، بدون بيير بيكس وإذا انقضت أو ألغيت، استخدم عقيدة مأذون بها حاليا؛ ولا تتدخل في الحديث.
403
تحقق identity.scopes for google_search و الدخول للاستعداد طلب الإذن المفقود من المالك؛ تغيير المصدر في الطلب لا يمنح إمكانية الوصول.
402
اقرأ التوازن مرة أخرى وقارنه بالثمن الحالي المالك يمكنه أن يستعرض Billing. وتحتاج التجربة المستنفدة إلى وصول المالك من خلال المطالبة؛ ولا يُسترجع إنشاء تجربة بديلة.
400 / 422
اقرأ رسالة الخطأ المعادة تحقق من مضيف البيانات الدقيق، وطريقة POST، و Content-Type، و JSON الاسمان الميدانيان. استخدام الاقتباسات المستقيمة والرقمية params.numثم تصحيح الطلب المرفوض.
429
(ب) احترام الـ (زكس كيزوك (Retry-After) إذا كان موجوداً؛ وخلافاً لذلك، استخدام التخلف المقيد والحد من الاتّفاق. لا تدور بسرعة، وتصنع مفاتيح جديدة أو تسجل تجربة أخرى لتجاوز الحدود.
HTTP 200 with failed status or error
اقرأ الخطأ في الجسم وحافظ على أي طلب أو وظيفة ID. لا تعاملوا هيئة من طراز JSON على أنها مهمة ناجحة أو إعادة تقديمها تلقائياً.
نتائج فارغة
إذا تم تحديد الوضع، فإن التوثيق يعمل. أبقوا النتيجة الفارغة أو حاولوا أن يُستفسروا على نطاق أوسع كطلب جديد مدفوع الأجر.
وقت الاستراحة، فقدان الاتصال، 5x أو HTML بدلا من JSON
قد يكون POST قد قُبل حتى إن فُقدت استجابته. تحقق من الاستعلام الأصلي في History واحتفظ بأي معرّفات عائدة قبل تقرير إعادة الإرسال. يمكن إعادة فحوص GET المجانية. تأكد من استخدام data.flashdata.dev وليس مضيف الموقع، ولا تعطّل التحقق من TLS.