الصق أمر cURL

للوكلاء

الدليل: الصق أمر cURL

هذه الصفحة: https://commentwatchdog.com/help/http-requests/paste-a-curl-command

الموضوع: طلبات HTTP

الوقت: حوالي 3 دقائق

من يمكنه القيام بذلك: المالك أو المسؤول أو المدير

المؤلف: https://anantgupta.xyz (Anant Gupta، مؤسس CommentWatchDog)

البدء في التطبيق: https://app.commentwatchdog.com/ar/inbox

النتيجة عند الانتهاء: الطلب مملوء من أمر cURL منسوخ من توثيق أي API، وجاهز للتجربة.

السياق: معظم توثيقات الـ API تعرض مثالًا على شكل أمر cURL. الصقه في خطوة «طلب HTTP» فتُملأ الطريقة والعنوان والـ headers والمصادقة والـ body تلقائيًا. والمفتاح الموجود في الأمر (header اسمه يشبه اسم مفتاح، أو access_key في العنوان، أو رمز طويل) يُجعل سريًا تلقائيًا.

قبل أن تبدأ

1. انسخ الأمر كاملًا من التوثيق، من كلمة curl إلى آخر سطر.

2. كل ما لا يستطيع المنشئ استخدامه يُذكر، ولا يُحذف بصمت أبدًا.

3. راجع الحقول، ثم ضع متغيرات مكان القيم النموذجية الواردة في التوثيق.

الخطوات

الخطوة 1 من 4: افتح «الصق أمر cURL».

المكان: في إعدادات خطوة «طلب HTTP»، «الصق أمر cURL»، في الأعلى، فوق «العنوان».

الرابط: https://app.commentwatchdog.com/ar/inbox (افتح التطبيق)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-http-curl.ar.webp («الصق أمر cURL»، مفتوحًا فوق «العنوان».)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-http-curl-phone.ar.webp (الأمر نفسه على الهاتف.)

يجب أن ترى: يُفتح مربع: «انسخ المثال من توثيق الـ API والصقه هنا. تُملأ الطريقة والعنوان والـ headers والمصادقة والـ body تلقائيًا.»

الخطوة 2 من 4: الصق الأمر واضغط «أنشئه».

المكان: الصق في المربع. الأمر السليم يُنشأ فورًا؛ وإلا فاضغط «أنشئه» (أو Ctrl أو ⌘ + Enter). و«إلغاء» يغلق المربع ولا يغيّر شيئًا.

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-http-curl.ar.webp (الأمر ملصوقًا في المربع (السطر الطويل يُمرَّر جانبيًا، فيظهر آخره)، و«أنشئه» تحته.)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-http-curl-phone.ar.webp (الأمر نفسه على الهاتف.)

يجب أن ترى: «أُنشئ من أمر cURL. راجع الحقول أدناه.» وكل ما تُرك يُذكر في السطر نفسه.

الخطوة 3 من 4: راجع الحقول.

المكان: «العنوان» (مع طريقته)، و«المصادقة»، و Body، و«معاملات الاستعلام»، و Headers تُملأ من الأمر. ضع متغيرات مكان القيم النموذجية الواردة في التوثيق حيث يجب أن تتغير القيمة لكل شخص، بزر {x}. والمفتاح القادم من الأمر يظهر «محفوظ ومخفي».

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-http-curl-built.ar.webp («أُنشئ من أمر cURL»: الملاحظة، والحقول مملوءة تحتها.)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-http-curl-built-phone.ar.webp (الأمر نفسه على الهاتف.)

يجب أن ترى: تعرض الخطوة على اللوحة الطريقة والعنوان.

الخطوة 4 من 4: أرسل طلبًا تجريبيًا.

المكان: في قسم «الاستجابة»، تحت Headers: املأ قيمة تجريبية لكل متغير، ثم «أرسل طلبًا تجريبيًا» («جرّب مجددًا» بعد أول تجربة).

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-http-test.ar.webp (طلب مجرَّب: 200، والوقت الذي استغرقه، و«يسلك مسار النجاح».)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-http-test-phone.ar.webp (الأمر نفسه على الهاتف.)

يجب أن ترى: الحالة، والوقت الذي استغرقه، و«يسلك مسار النجاح»، ثم «الحقول التي أعادها».

إذا واجهت مشكلة ما

المشكلة: لا يبدو هذا أمر cURL يحتوي على عنوان

الحل: انسخ الأمر من جديد من أوله (curl …) مع العنوان.

المشكلة: جزء تُرك

الحل: السطر الذي بعد «أنشئه» يذكر ما تُرك. أضفه يدويًا في قسمه من النموذج.

المشكلة: مفتاح يظهر «محفوظ ومخفي»

الحل: المفاتيح الموجودة في الأمر تُجعل سرية عمدًا. و«استبدال» يضع مفتاحًا جديدًا.

أسئلة شائعة

سؤال: ماذا يملأ أمر cURL الملصوق؟

جواب: الطريقة، والعنوان، والـ headers، والمصادقة، والـ body، من الأمر كما هو مكتوب في التوثيق.

سؤال: هل مفتاح API الموجود في أمر cURL يُخزَّن بأمان؟

جواب: نعم. المفتاح الموجود في الأمر يُجعل سريًا تلقائيًا ويُحفظ مشفّرًا؛ ولا يراه أحد مجددًا، ولا حتى في سجل التشغيلات.

أدلة ذات صلة

أرسل طلب HTTP من تدفق: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow

استخدام الاستجابة في تدفقك: https://commentwatchdog.com/help/http-requests/use-the-answer-in-your-flow

إنشاء الطلب بالذكاء الاصطناعي: https://commentwatchdog.com/help/http-requests/build-the-request-with-ai

النص العادي لهذا الدليل: https://commentwatchdog.com/help/http-requests/paste-a-curl-command.md

كل الأدلة للمساعدين: https://commentwatchdog.com/help/llms.txt