Hi 👋,

Thanks for using Falcon. The large amount of time and effort needed to
maintain the project and develop new features is not sustainable without
the generous financial support of community members like you.

Please consider helping us secure the future of the Falcon framework with a
one-time or recurring donation.

Thank you for your support!

Hi @yarin177 !
Your application code looks just fine!
You could simplify it somewhat by using the Falcon media handlers, but the choice is yours 🙂

I would guess the problem is that you are sending your request payload as URL-encoded (application/x-www-form-urlencoded) instead of JSON.

The following snippet works for me (I just extended your example slightly to showcase media, but your original responder is also left intact):

import json

import falcon


class TextOcrRes:
    def on_post(self, req, resp):
        """Handles Text POST requests"""
        json_data = json.loads(req.bounded_stream.read().decode("utf-8"))
        print(json_data)


class TextOcrMediaRes:
    def on_post(self, req, resp):
        """Showcase Falcon media framework"""
        print(req.media)


app = falcon.API()
app.add_route('/translate', TextOcrRes())
app.add_route('/translate2', TextOcrMediaRes())

>>> requests.post('http://localhost:8000/translate', json={'image_data':'message1'})
<Response [200]>
>>> requests.post('http://localhost:8000/translate2', json={'image_data':'message2'})
<Response [200]>

I'll leave the issue open for a while.
Maybe we should add an example in our tutorial how to actually send a JSON request?
IIRC you're not first to get confused by this, even though it is not strictly a Falcon issue.

Thank you, that solved the issue for me, and yes I'm sure it will be helpful if you can include an example for sending JSON in the tutorial.
I'm just curious, when will you send "data" for the server?

@yarin177 Whenever an applications expect it, or at least supports it, and you want to test it 🙂

Although newly designed RESTful APIs typically prefer JSON (or YAML, Msgpack etc), application/x-www-form-urlencoded is still ubiquitous since it is the default content type for an HTML <form> that the web browser POSTs upon clicking the submit button.

@yarin177 Whenever an applications expect it, or at least supports it, and you want to test it 🙂

Although newly designed RESTful APIs typically prefer JSON (or YAML, Msgpack etc), application/x-www-form-urlencoded is still ubiquitous since it is the default content type for an HTML <form> that the web browser POSTs upon clicking the submit button.

about your other solution using media, I'm basically trying to send over an image from a client to the server and save it. but I don't know if I should send it with JSON or DATA or FILES
I tried this on the client:

data = open('test.png','rb').read()
r = requests.post("http://localhost:8000/translate", data=data)

But How do I receive it on the server? do I need to encode it, JSON?

Answered the sending image question on #1637.