Document POST body example

After a bunch of experimentation, I figured out that you can use a POJO as a POST body, but I couldn’t find it anywhere in the documentation. e.g. You can do

public interface Boop {
    @RequestLine("POST /boop/{someParam}")
    @Headers({
        "Accept: application/json",
        "Content-Type: application/json"
    })
    BoopResponse createBoopUsingPOST(Boop boop, @Param("someParam") String someParam);

    class Boop {
        public String value;
    }
}

But the tricky part is that the POJO param (boop, in the example), must come first in the parameter list of the method. That was difficult to find out!

[kdavisk6]

@wulftone

Thanks for this example. It is missing from the documentation. You can define the body of the request two ways:

• annotating the parameter with @Body
• the first method parameter without an annotation is assumed to be the Body

We should update the documentation to explain this and add you example.

[eiselems]

@sleroy hoped the example would be sufficient

  @RequestLine("POST /repos/{owner}/{repo}/issues")
  void createIssue(Issue issue, @Param("owner") String owner, @Param("repo") String repo);

How should we improve it?