From 7bf4d02da823c21b27cf20ba0b764b511ac69432 Mon Sep 17 00:00:00 2001 From: adamw Date: Thu, 12 Oct 2017 19:23:09 +0200 Subject: More docs --- docs/json.rst | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/json.rst (limited to 'docs/json.rst') diff --git a/docs/json.rst b/docs/json.rst new file mode 100644 index 0000000..28cee81 --- /dev/null +++ b/docs/json.rst @@ -0,0 +1,29 @@ +JSON +==== + +JSON encoding of bodies and decoding of responses can be handled using +`Circe `_ by the ``circe`` module. To use +add the following dependency to your project:: + + "com.softwaremill.sttp" %% "circe" % "0.0.20" + +This module adds a method to the request and a function that can be given to +a request to decode the response to a specific object. + + import com.softwaremill.sttp._ + import com.softwaremill.sttp.circe._ + + implicit val backend = HttpURLConnectionBackend() + + // Assume that there is an implicit circe encoder in scope + // for the request Payload, and a decoder for the Response + val requestPayload: Payload = ??? + + val response: Either[io.circe.Error, Response] = + sttp + .post(uri"...") + .body(requestPayload) + .response(asJson[Response]) + .send() + + -- cgit v1.2.3