aboutsummaryrefslogtreecommitdiffstats
path: root/guide/rest_handlers.md
diff options
context:
space:
mode:
Diffstat (limited to 'guide/rest_handlers.md')
-rw-r--r--guide/rest_handlers.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/guide/rest_handlers.md b/guide/rest_handlers.md
index d5997f9..ac11d98 100644
--- a/guide/rest_handlers.md
+++ b/guide/rest_handlers.md
@@ -106,6 +106,19 @@ each function. For example, `from_html` and `to_html` indicate
in the first case that we're accepting a resource given as HTML,
and in the second case that we send one as HTML.
+Cowboy will set informative meta values at various points of the
+execution. You can retrieve them using `cowboy_req:meta/{2,3}`.
+The values are defined in the following table.
+
+| Meta key | Details |
+| -----------| ---------------------------------------------------- |
+| media_type | The content-type negotiated for the response entity. |
+| language | The language negotiated for the response entity. |
+| charset | The charset negotiated for the response entity. |
+
+They can be used to reply a response entity to a request with
+an idempotent method (`POST`, `PUT`, `PATCH`, `DELETE`).
+
Usage
-----