Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

"Backend Developers are UX Designers Too" could be extended #166

Closed
JudithVanDongen-Kramp opened this issue Jan 23, 2025 · 0 comments
Closed

Comments

@JudithVanDongen-Kramp
Copy link

I really liked this blog: https://blog.boot.dev/clean-code/backend-ux-design/
But I would like to see it extended.

The blog talks about the UX of an API and then shows an example of bad API design. But the example only shows 'happy flows'.
I have noticed that bad API design can also be visible in the error responses.
The error response should never contain a technical error: "Cannot call method 'toString of undefined'".
Instead, the error message should be meaningful, such as "The name should be provided" or "The provided quantity should be a number."

Also, the HTTP return code in the response can tell you a lot about the error.
I hate responses that have a 200 return code, but then the body contains an error.

Hopefully, these examples show a more extensive view on UX for API's.

@wagslane wagslane closed this as completed Feb 4, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants