طلب HTTP GET من ESP32: جلب حالة الطقس
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
معظم المشاريع المتصلة بالشبكة هي لوحة تطلب من خادم قطعة صغيرة من البيانات وتفعل بها شيئًا: الطقس، الوقت، أو إعدادًا ما. على ESP32 في عالم Arduino هذه هي مكتبة HTTPClient، والنمط هو دائمًا الخطوات الخمس نفسها: الانضمام إلى الشبكة، بدء طلب، تنفيذ GET، قراءة المتن، إنهاء الطلب.
الدائرة أعلاه هي ESP32-C3 يشغّل مثال «جلب حالة الطقس» المدمج عبر WiFi. قبل كل شيء، الجزء الصريح: الشبكة في Mokxi محاكاة. لا يوجد راديو، ولا شيء يغادر تبويب متصفحك ما لم تسجّل الدخول وتفعّل الإنترنت الحقيقي. أربعة أسماء مفترضة تجيب (time.mokxi وweather.mokxi وecho.mokxi وapi.mokxi)، وكود اللوحة هو الكود الذي سترفعه إلى ESP32 حقيقي. اضغط «تشغيل» وستُظهر الشاشة التسلسلية نقاط حلقة الاتصال، ثم "IP address: 192.168.4.2"، ثم كل خمس ثوانٍ:
كل عملية جلب تطبع "HTTP 200"، ثم المتن، {"location":"Mokxi","temperatureC":21.5,"humidity":48,"simulated":true}، ثم الرقمين اللذين استخرجهما الكود: "temperature: 21.5 C" و"humidity: 48 %".
الخطوات الخمس
WiFi.begin(ssid, password) starts joining, and the sketch waits in a loop until WiFi.status() returns WL_CONNECTED. Then, for each request, it makes a WiFiClient and an HTTPClient, calls http.begin(client, url), and http.GET() sends the request and waits for the reply. GET returns the HTTP status code, 200 for success, and http.getString() returns the body. http.end() frees the connection.
هناك تفصيلان مهمان على العتاد الحقيقي. تحقق من الكود قبل استخدام المتن: الرقم السالب يعني أن الطلب لم يكتمل أبدًا (لا شبكة، أو اسم لا يُحلَّل، أو مهلة انتهت)، أما 404 أو 500 فيعني أن الخادم أجاب بخطأ. وستدعو end() دائمًا، حتى بعد الفشل، حتى يُحرَّر الاتصال ومخازنه قبل الطلب التالي؛ اللوحة التي تتخطى ذلك قد تسرّب قليلًا من الذاكرة مع كل طلب حتى تتوقف عن العمل.
WiFiClient client;
HTTPClient http;
http.begin(client, "http://weather.mokxi/");
int code = http.GET();
if (code <= 0) {
Serial.print("request failed: ");
Serial.println(HTTPClient::errorToString(code));
http.end();
return;
}
Serial.print("HTTP ");
Serial.println(code);
String body = http.getString();
http.end();استخراج الأرقام من JSON
الرد بصيغة JSON، وهي صيغة نصية صغيرة من أسماء وقيم. يجد هذا الكود النص "temperatureC"، ويتخطى علامة الاقتباس والنقطتين وأي مسافات، ثم ينسخ المحارف حتى الفاصلة أو القوس المغلق التاليين. هذا كافٍ لرد مسطّر تتحكم فيه، ويحافظ على سهولة قراءة الكود. لأي متداخل أو من خدمة خارجية، استخدم محللًا حقيقيًا؛ على لوحة فعلية يثبّت معظم الناس مكتبة ArduinoJson.
افتح تبويب Cloud بجانب Serial أثناء التشغيل. يسرد كل طلب أجرته اللوحة مع حالته ومتنه، وفيه حقولان للأرقام التي يجيب بها weather.mokxi. غيّر درجة الحرارة إلى 30 وستطبع عملية الجلب التالية، بعد خمس ثوانٍ على الأكثر، "temperature: 30 C". هذه هي الرحلة الكاملة نفسها التي تقوم بها لوحة حقيقية إلى خدمة طقس حقيقية، مع الخادم تحت سيطرتك.
عندما يفشل الطلب
يطلب الكود عمدًا http://example.com/ مرة واحدة في setup()، ومع إيقاف الإنترنت الحقيقي تطبع الشاشة التسلسلية سبب الفشل: لا إنترنت حقيقي، الأسماء تحت .mokxi فقط. اللوحة الحقيقية التي لا تجد مسارًا إلى خادم تفشل في المكان نفسه، عند GET، برمز سالب، وطباعة HTTPClient::errorToString(code) هي أسرع طريقة لمعرفة السبب.
للتدرّب على التعامل مع أخطاء الخوادم، افتح مثال مختبر API بالزر أدناه. يطلب http://api.mokxi/data، ويتيح لك تبويب Cloud اختيار رمز الحالة وJSON الذي يأتي في الرد. اضبطه على 404 أو 500 وشاهد ما يفعله كودك برد لم يتوقعه. عناوين https:// تفشل هنا عن قصد، مع رسالة تفيد بأن TLS غير محاكى؛ على ESP32 حقيقي يحتاج طلب https إلى WiFiClientSecure وشهادة الخادم.
عادات تستحق البناء
لا تطلب كثيرًا. خدمة الطقس الحقيقية تحدّث بياناتها كل بضع دقائق، وكثير منها يحدّ عدد مرات الاستدعاء لمفتاح واحد؛ كل خمس ثوانٍ مقبول مع weather.mokxi وكثير جدًا لمعظم الخدمات الحقيقية. مرة في الدقيقة أو أقل خيار مهذّب افتراضي.
لا تكشف الأسرار في كود مشترك. الكود الذي يحتوي كلمة مرور WiFi أو مفتاح API يذهب إلى حيث تلصقه. ضعها في ملف رأسي منفصل لا تشاركه، وغيّر كلمة المرور لأي شبكة انتهت تفاصيلها في منشور عام.
طلب GET المُعطِّل يعطّل كل شيء. الدالة http.GET() تنتظر الرد، فبينما تنتظر لا يقرأ الكود الأزرار ولا يحدّث الشاشة. في Mokxi يكلّف الطلبُ الكودَ رحلته المحاكاة كما يحدث على العتاد، ولهذا فإن المشروع الذي يجب أن يبقى مستجيبًا يجلب البيانات نادرًا ويؤدي عمله الآخر بالدالة millis() بدلًا من delay().
افتح هذه الدائرة في المحرر. ESP32-C3: يجلب حالة الطقس، موصّلًا كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّله من جديد.
الأسئلة
ما اللوحات التي يمكنها تشغيل هذا؟
في Mokxi، اللوحات التي تحمل راديو على العتاد الحقيقي: ESP32-C3 وESP32-C6 وESP32 DevKit الكلاسيكية وESP8266 NodeMCU وRaspberry Pi Pico W. المثال نفسه متوفر لكل منها.
هل يمكن لكودي الوصول إلى موقع حقيقي من المحاكي؟
نعم، بعد تسجيل الدخول. فعّل «الإنترنت الحقيقي» في لوحة Cloud، فتخرج طلبات HTTP وHTTPS إلى المضيفين الحقيقيين عبر بوابة Mokxi. وعندما يكون معطلًا، لا تُحلَّل سوى الأسماء تحت .mokxi، ولا شيء يغادر تبويب المتصفح، وأي شيء آخر يُرجع خطأً مع جملة واحدة تشرح السبب.
ماذا يعني رمز HTTP بقيمة -1 على ESP32؟
أن الاتصال رُفض أو تعذّر إنشاؤه: غالبًا لا توجد WiFi، أو عنوان خاطئ، أو خادم غير موجود. الدالة HTTPClient::errorToString(code) تطبع السبب بالكلمات.
هل أستخدم GET أم POST؟
GET لقراءة البيانات، وPOST لإرسالها، مثل قراءة حساس إلى خدمة تسجيل. توفر HTTPClient الدالة http.POST(body)، وecho.mokxi يجيب على POST بالمتن الذي أرسلته، فيمكنك تجربته هنا.
لماذا تعود http.getString() فارغة؟
غالبًا لأن الطلب فشل وكان الرمز سالبًا، أو لأن الخادم أجاب بلا متن، كما يفعل رمز 204. اطبع رمز الحالة أولًا؛ إذا كان 200 والمتن لا يزال فارغًا، اطبع http.getSize() لترى كم بايتًا قال الخادم أنه سيرسله.
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.