HTTP Requests (urequests)

This extension allows you to make http request (ie. retrieve webpages). You can use this to retrieve normal webpages, as well as useful data (eg. weather) from public APIs.

You can find a list of public APIs here https://github.com/public-apis/public-apis. Many more can be found if you dig around online.

You can also retrieve webpages (HTML), but be warned that some webpages may be very large, and your device may not have enough memory to load the entire page.

Code

This code will retrieve the maximum temperature in Singapore today from Open-Meteo.

It will display the full data returned by Open-Meteo, then extract out and print just the max temperature.

If you want to retrieve other weather data, you'll need to change the URL. Open this page, https://open-meteo.com/en/docs, change the settings, then get the new URL from the API URL section.

Blocks

You must put in your actual WiFi SSID and password in the Connect to WiFi block, or this will not work.

The above screenshot does not show the full URL, it should be https://api.open-meteo.com/v1/forecast?latitude=1.2897&longitude=103.8501&daily=temperature_2m_max&timezone=Asia%2FSingapore&forecast_days=1 (...in a single line).

Most web-based APIs will return JSON data. If your API isn't returning JSON, or if you are retrieving a webpage, then you'll need to set the format as Text.

Python

import ioty.wifi
import urequests

ioty_wifi = ioty.wifi.connect('SSID', 'password') # Put in actual WiFi SSID/Password
print('Connected to WiFi')

try:
    urequest = urequests.request('GET', 'https://api.open-meteo.com/v1/forecast?latitude=1.2897&longitude=103.8501&daily=temperature_2m_max&timezone=Asia%2FSingapore&forecast_days=1')
    item = urequest.json() # JSON decode the response and put the result in "item"
    urequest.close()
except: # If the request fails (eg. server down), it will throw an exception.
    pass
print(item) # Print everything
print('Max Temperature:', item['daily']['temperature_2m_max'][0])

Results

A few seconds after reset, you should see "Connected to WiFi", which indicates that your device has successfully connected to your WiFi. If this does not appear, you'll need to troubleshoot your WiFi connection. Check that...

• WiFi SSID and Password are correct.
• WiFi SSID is for 2.4GHz and not 5GHz.

After connecting to WiFi, your device will retrieve data from Open-Meteo, and print it twice; the first will show all the data returned, while the second will only show the max temperature.

urequests - send and retrieve data via HTTP