الدليل: استخدام الاستجابة في تدفقك
هذه الصفحة: https://commentwatchdog.com/ar/help/http-requests/use-the-answer-in-your-flow
الموضوع: طلبات HTTP
الوقت: نحو 4 دقائق
من يمكنه القيام بذلك: المالك أو المسؤول أو المدير
المؤلف: https://anantgupta.xyz (Anant Gupta، مؤسس CommentWatchDog)
ابدأ في التطبيق: https://app.commentwatchdog.com/ar/inbox
النتيجة عند الانتهاء: قيم من استجابة الـ API تُستخدم في رسائلك وشروطك التالية، أو تُحفظ على الشخص لوقت لاحق.
السياق: سمِّ الاستجابة مرة واحدة فيدخل كل حقل تعيده في الرسائل والطلبات والشروط اللاحقة بذلك الاسم، مثل {{order.items[0].name}} أو {{order.$status}}. جرّب الطلب فعليًا بقيم تجريبية فتعرض الخطوة الحقول التي أعادها مع قيمها، جاهزة للإدراج. والقيمة التي تستحق البقاء بعد هذه المحادثة يمكن حفظها في جهة الاتصال: كبريده أو هاتفه أو اسمه، أو كحقل محفوظ تقرؤه التشغيلات والشروط اللاحقة أيضًا.

قبل أن تبدأ:
1. التجربة تجري الاستدعاء الحقيقي من خادمنا، بقيم تجريبية مكان المتغيرات.
2. حتى 30 طلبًا تجريبيًا في الدقيقة لكل شخص.
3. تُقرأ الاستجابة حتى 512 KB؛ وحتى 20 قيمة تُحفظ في جهة الاتصال لكل خطوة.

الخطوات:
الخطوة 1 من 4: سمِّ الاستجابة وأرسل طلبًا تجريبيًا.
أين: في قسم «الاستجابة» من الخطوة، تحت Headers: «اسم الاستجابة» (مثلًا ship)، ثم «قيم تجريبية لمتغيراته» (مثلًا 97205 للمتغير zip)، ثم «أرسل طلبًا تجريبيًا». وبعد أول تجربة يصبح الزر «جرّب مجددًا».
الرابط: https://app.commentwatchdog.com/ar/inbox (افتح التطبيق)
لقطة الشاشة: https://commentwatchdog.com/media/shots/dm-node-http-more.ar.webp (قسم «الاستجابة»: «اسم الاستجابة»، والقيمة التجريبية، و«أرسل طلبًا تجريبيًا».)
لقطة الشاشة: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.ar.webp (قسم «الاستجابة» على الهاتف.)
ما يجب أن تراه: تحت الزر: الحالة (200)، والوقت الذي استغرقه، والمخرج الذي كان سيسلكه، «يسلك مسار النجاح» أو «يسلك مسار الفشل». و«الاستجابة» و Headers و«ما أُرسل»، تحت الحقول، تفتح الاستجابة الخام وما أُرسل بالضبط.

الخطوة 2 من 4: اختر الحقل الذي تحتاجه من «الحقول التي أعادها».
أين: تحت النتيجة، «الحقول التي أعادها» تعرض كل قيمة في الاستجابة حسب موضعها، والقيمة تحتها: «رمز الحالة» 200، و country قيمته United States، و places[0].place name قيمته Portland. وزر النسخ في الصف ينسخ متغيره، مثل {{ship.places[0].place name}}. والخطوات اللاحقة تجدها أيضًا تحت زر المتغيرات، في «من استدعاءات الـ API».
لقطة الشاشة: https://commentwatchdog.com/media/shots/dm-http-test.ar.webp («الحقول التي أعادها»: كل قيمة في الاستجابة، وفي صفها زر النسخ و«احفظ في جهة الاتصال».)
لقطة الشاشة: https://commentwatchdog.com/media/shots/dm-http-test-phone.ar.webp (الأمر نفسه على الهاتف.)
ما يجب أن تراه: تحت القائمة: «أدرج أيًا منها لاحقًا بزر المتغيرات. انسخ واحدًا لتلصقه بنفسك.» وتبقى الحقول معروضة (من آخر تجربة) بعد إغلاق الخطوة.

الخطوة 3 من 4: احفظ قيمة في جهة الاتصال، إن كان يجب أن تبقى بعد هذه المحادثة.
أين: «احفظ في جهة الاتصال»، في صف الحقل، يفتح أربعة اختيارات: «بريده»، أو «هاتفه»، أو «اسمه»، أو «حقل محفوظ». وبعدها يعرض زر الصف الاختيار، وتظهر القيمة تحت «محفوظ في جهة الاتصال»، أسفل الحقول، حيث تستطيع تغيير وجهتها أو إزالتها.
لقطة الشاشة: https://commentwatchdog.com/media/shots/dm-http-save.ar.webp («احفظ في جهة الاتصال»، مفتوحة على حقل: «بريده»، «هاتفه»، «اسمه»، «حقل محفوظ».)
لقطة الشاشة: https://commentwatchdog.com/media/shots/dm-http-save-phone.ar.webp (الأمر نفسه على الهاتف.)
ما يجب أن تراه: تحت «محفوظ في جهة الاتصال»: موضع الحقل في الاستجابة (places[0].place name)، ووجهته، و«آخر تجربة:» مع القيمة التي قرأها (Portland).

الخطوة 4 من 4: استخدمها في رسالة أو شرط.
أين: في رسالة لاحقة، اضغط زر المتغيرات {x} بجانب «إدراج»، تحت النص. تُفتح قائمته على «من استدعاءات الـ API»: رمز حالة الاستجابة (ship.$status، مع 200 من آخر تجربة) والقيمة التي احتفظت بها كمتغير (city). أدرج واحدًا، مثلًا: خبر سار! تصل القهوة إلى {{city}} خلال 3 إلى 5 أيام عمل. وفي خطوة «شرط»، تحقق من القيمة أو من رمز الحالة.
لقطة الشاشة: https://commentwatchdog.com/media/shots/dm-http-use.ar.webp (الرسالة التي بعد «نجاح»، وفي نصها {{city}}: زر المتغيرات مفتوح على «من استدعاءات الـ API».)
لقطة الشاشة: https://commentwatchdog.com/media/shots/dm-http-use-phone.ar.webp (الأمر نفسه على الهاتف.)
ما يجب أن تراه: تعرض الرسالة المتغير بين قوسين مزدوجين، هنا {{city}}، في اللوحة الجانبية وعلى الخطوة؛ وفي تشغيل تجريبي تعرض القيمة الحقيقية.

إذا كان هناك خطأ ما:
المشكلة: لم تظهر في آخر تجربة
الحل: المسار الذي حفظته ليس في أحدث استجابة. جرّب مجددًا بقيم تجريبية تعيده.
المشكلة: رسالة تعرض المتغير فارغًا
الحل: القيمة تُستخدم قبل أن تتمكن خطوة HTTP الخاصة بها من العمل، أو أن الطلب سلك مخرج «فشل». والمنشئ ينبّه حين تُستخدم استجابة قبل خطوتها.
المشكلة: جرّب الطلب لترى الحقول التي يعيدها
الحل: لم تُجرَ أي تجربة بعد. املأ القيم التجريبية واضغط «أرسل طلبًا تجريبيًا».
المشكلة: تجارب كثيرة خلال دقيقة
الحل: حتى 30 تجربة في الدقيقة لكل شخص. انتظر لحظة ثم جرّب مجددًا.

أسئلة شائعة:
سؤال: هل أستطيع حفظ قيمة من الـ API في جهة الاتصال؟
جواب: نعم. «احفظ في جهة الاتصال» على أي حقل في الاستجابة: كبريده أو هاتفه أو اسمه، أو كحقل محفوظ تقرؤه التشغيلات والشروط اللاحقة أيضًا.
سؤال: هل يستطيع شرط أن يتحقق من استجابة الـ API؟
جواب: نعم. كل حقل في استجابة مسمّاة هو متغير تستطيع خطوة «شرط» أن تتحقق منه، ومع ضبط «يُعدّ نجاحًا» على «أي استجابة»، رمز الحالة أيضًا.
سؤال: هل الطلب التجريبي يستدعي الـ API فعلًا؟
جواب: نعم. يجري الاستدعاء الحقيقي من خادمنا بقيمك التجريبية ويعرض الاستجابة والـ headers وما أُرسل بالضبط، مع حجب الأسرار.

أدلة ذات صلة:
- أرسل طلب HTTP من تدفق: https://commentwatchdog.com/ar/help/http-requests/send-an-http-request-from-a-flow
- الحقول المخصصة: https://commentwatchdog.com/ar/help/people/custom-fields
- إنشاء الطلب بالذكاء الاصطناعي: https://commentwatchdog.com/ar/help/http-requests/build-the-request-with-ai

النص العادي لهذا الدليل: https://commentwatchdog.com/ar/help/http-requests/use-the-answer-in-your-flow.md
كل الأدلة للمساعدين: https://commentwatchdog.com/ar/help/llms.txt