How to send a JSON POST request using Retrofit in Android, and recieve a String response

Question

I'm using Retrofit2 for the first time and have a few issues.

This is the code snippet used to call the REST API

    //building retrofit object
    Retrofit retrofit = new Retrofit.Builder()
            .baseUrl("http://192.168.0.71:9000/api/uniapp/")
            .addConverterFactory(GsonConverterFactory.create())
            .addConverterFactory(ScalarsConverterFactory.create())
            .build();

    APIService service = retrofit.create(APIService.class);

    //defining the call
    Call<String> call = service.refreshAppMetaConfig("0");
    //calling the api
    call.enqueue(new Callback<String>() {
        @Override
        public void onResponse(Call<String> call, Response<String> response) {
            //displaying the message from the response as toast
            System.out.println("Uniapp :"+response);
        }

        @Override
        public void onFailure(Call<String> call, Throwable t) {
            System.out.println("Uniapp :"+t.getMessage());
        }
    });

This is the APIService class :

public interface APIService {

    //The register call
    @FormUrlEncoded
    @POST("appmetaconfigjson")
    Call<String> refreshAppMetaConfig(@Field("versionId") String versionId);
}

I'm using Play framework for creating the REST API. I am getting an internal server error. The API is not able to read the JSON request. But if I hit the API through Postman, it returns the response. Any suggestions?

Ive added the postman request screenshot.

Possible duplicate of [How to POST raw whole JSON in the body of a Retrofit request?](https://stackoverflow.com/questions/21398598/how-to-post-raw-whole-json-in-the-body-of-a-retrofit-request) — ADM, Aug 31 '18 at 07:56
try add this on your ApiService `@Headers("Content-Type: application/x-www-form-urlencoded")` — Mochamad Taufik Hidayat, Aug 31 '18 at 08:06
also double check your url endpoint & param maybe there something wrong — Mochamad Taufik Hidayat, Aug 31 '18 at 08:09
When i insert the header, it says, "Annotations are not allowed here". — Arjun Issar, Aug 31 '18 at 08:11
Also, if i hit the same api using Postman, its working fine. — Arjun Issar, Aug 31 '18 at 08:11
your param using raw so it might change on your api service, try this reference https://stackoverflow.com/questions/21398598/how-to-post-raw-whole-json-in-the-body-of-a-retrofit-request — Mochamad Taufik Hidayat, Aug 31 '18 at 08:41

Shashanth · Accepted Answer · 2019-09-15T23:21:42.257

As I can see from your screenshots of Postman, you're sending JSON body to REST API. When you select body type as raw - application/json in Postman, it automatically includes

Content-Type:application/json

as header. Hence, the request is successful in Postman.

Now, in order to make it work above request successfully in your Android application, you need to set headers with the request you send to REST API.

In APIService interface do the below changes.

import retrofit2.http.Body;
import okhttp3.ResponseBody;
import java.util.Map;


public interface APIService {

  //The register call
  // @FormUrlEncoded    <====  comment or remove this line

   @Headers({
        "Content-Type:application/json"
   })
   @POST("appmetaconfigjson")
   Call<ResponseBody> refreshAppMetaConfig(@Body Map<String, String> versionId);
}

Remove or comment @FormUrlEncoded annotation as we're sending JSON not FormUrlEncoded data.
Add @Headers() annotation with Content-Type:application/json
Change method parameter to @Body Map<String, String> versionId. The @Body annotation converts (serializes) Map (HashMap) data into JSON body when you request to API.
Change return parameter from String to ResponseBody.

Use the above-modified method as below

// code...

//defining the call

// create parameter with HashMap
Map<String, String> params = new HashMap<>();
params.put("versionId", "0");

Call<ResponseBody> call = service.refreshAppMetaConfig(params);
//calling the api
call.enqueue(new Callback<ResponseBody>() {
    @Override
    public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
        //displaying the message from the response as toast

        // convert ResponseBody data to String
        String data = response.body().string();

        System.out.println("Uniapp : " + data);
    }

    @Override
    public void onFailure(Call<ResponseBody> call, Throwable t) {
        System.out.println("Uniapp : " + t.getMessage());
    }
});

Here also you need to change parameter from Call<String> to Call<ResponseBody>. And convert the response inside onResponse() method using response.body().string();.

Please check method names, imports and parameters used in answer properly or just copy paste the code if you have any confusion. — Shashanth, Sep 01 '18 at 05:30

How to send a JSON POST request using Retrofit in Android, and recieve a String response

1 Answers1