Creating Json Responses in Go

Real APIs usually return JSON, not plain text. In this Go Byte, you'll learn how to encode structs as JSON inside a handler, set the Content-Type header so the client knows it is JSON, and handle encoding errors with a proper status code.

What You'll Learn:
- How to define a struct and encode it as JSON in a handler
- How to set the Content-Type header to application/json
- How json.NewEncoder(w).Encode writes JSON directly to the response
- How to handle encoding errors and return 500 with http.Error

Conceptual Explanation:
JSON responses start with a struct that has JSON tags. You set the Content-Type header to application/json before writing, so the client knows how to interpret the body. json.NewEncoder(w).Encode(yourStruct) marshals the struct to JSON and writes it straight to the response writer. Whatever you write to w becomes the response body. If encoding fails, use http.Error to send a 500 status and a plain text error message. Headers must be set before writing the body.

How It Fits:
This builds on starting a server, handling routes, and writing responses. You already know how to write to the response writer. Now you are writing JSON instead of plain text and setting the right header. The json-tags lesson gives you the struct shape; this lesson puts that JSON in an HTTP response. Together they form the basis of JSON APIs in Go.

Key Takeaways:
- Structs with JSON tags define the shape of your response
- Set Content-Type to application/json before writing the body
- json.NewEncoder(w).Encode writes JSON directly to the response
- Check the error from Encode and return 500 if it fails
- http.Error sets the status code and writes a plain text message

Try the challenge from the video before checking the solution.

Links:
Lesson folder on GitHub: https://github.com/GaryClarke/go-bytes/tree/main/json-responses
Build your first Go app with me: https://www.garyclarke.tech/p/build-your-first-go-app
Join the mailing list for new lessons and resources: https://content.garyclarke.tech/go-bytes-signup
Follow on X/Twitter: https://twitter.com/garyclarketech
Connect on LinkedIn: https://www.linkedin.com/in/garyclarketech/

Subscribe for more Go lessons.

#golang #go #programming #coding #learnprogramming #gobytes

Видео Creating Json Responses in Go канала Gary Clarke