For this example we'll use the /set_pixel
endpoint to set a specific pixel on the canvas. Firstly we want to import our HTTP library, for now we'll use the requests (pip install requests) library.
This guide will use the [requests](<https://pypi.org/project/requests/>)
library but you can use [httpx](<https://pypi.org/project/httpx/>)
, [aiohttp](<https://pypi.org/project/aiohttp/>)
or any client side HTTP library of your preference to interact with pixels.
You'll need to follow the Authentication guide and get to a stage where you can access your token in your Python script.
We need to create the authorization header for making API requests. We'll simply create a dictionary:
# Where "token" is your token from earlier.
HEADERS = {
"Authorization": f"Bearer {token}"
}
Next, we will create the actual data we're going to send to the API, in this case we will set the pixel at (123, 12)
to the hex value #87CEEB
:
data = {
"x": 123,
"y": 12,
"rgb": "87CEEB",
}
Finally, we can make the API request itself, for which we'll need to use the post
method of requests to send a HTTP POST
to the pixels webserver:
result = requests.post(
"<https://pixels.pythondiscord.com/set_pixel>",
json=data,
headers=HEADERS
)
# raise_for_status will cause Requests to throw an error if the Pixels API responds with a non-200 (success) code.
result.raise_for_status()
To check that the request went through correctly we'll print out the confirmation message that the API provides us with:
print(result.json()["message"])
Which will print, in this case, added pixel at x=123,y=12 of color 87CEEB
.