When creating a REST API, if I return data in JSON format for GET requests, is it a good practice to also send responses for POST, PUT, DELETE, and error messages in JSON too or plain text will suffice?
For POST request where I need to return the new ID of the newly added record (i.e. just the new auto increment value in database), should the response still be in JSON or just plain text like "1" or "2" for example.
Same goes for PUT or DELETE request where I need to say "OK" or "Accepted", as well error messages like "Bad Request", "Not Found", etc.
Plain text or JSON?
preguntado el 31 de julio de 12 a las 14:07
Use the client-provided
Accept encabezamiento to let the client control what content type they want. If no header is provided, then use a sensible default and siempre Incluir un
Content-Type encabezamiento in the response. See the Content Negotiation section of RFC2616 para más información.
Theoretically, returning just "1" is valid JSON. It's just not a array or associative mapping.
For OK and Accepted, you can just use the HTTP status codes for those. No body is really necessary.
It depends entirely on the ability the client has.
Of course, you don't actually have to choose one or the other: you can use content-type negotiation to return a different representation depending on the user-agent's acceptance list.