对接第三方接口遇到的坑

工作需要对接第三方市建委接口,接口文档传参规范如下

看到这些第一反应,json格式传参,content-type为application/json,然后直接就开始在代码里使用restTemplate进行接口调用,原始代码如下(同事写的)

// 通过url传递参数
public static Integer basisInfo(String token, HashMap<String, Object> params,String url) {
    HttpHeaders headers = new HttpHeaders();
    headers.add("Authorization", token);
    headers.add("Content-Type", "text/plain;charset=UTF-8");
    HttpEntity<Object> httpEntity = new HttpEntity<Object>(null, headers);
    String json = JSONUtil.toJsonStr(defaultParams(params));
    String urlParams = url + "?params={json}"; //在url中拼接参数,同事写的方式
    ResponseEntity<String> responseEntity = restTemplate.exchange(urlParams, HttpMethod.POST, httpEntity, String.class, json);
    return JSON.parseObject(responseEntity.getBody()).getJSONObject("status").getInteger("code");
}

以上代码,其他接口可以,但此接口的参数巨多,有200多个字段,调用报错,便跟着报错信息百度各种查,两天任然没有办法解决,以为是第三方接口有问题,怎么这种接收参数的方式
中途将 text/plain 改为 application/json ,并在HttpEntity中传入参数,不行!
修改参数格式,还是不行!
最后使用postman测试是不是接口的问题,将params参数放到url后拼接,请求失败,没有任何返回信息,再将params参数放到body的form-data参数中,请求成功!

//修改请求方式为multipart/form-data
public static Integer invokeApiPost(String token, HashMap<String, Object> params,String url) {
    HttpHeaders headers = new HttpHeaders();
    headers.add("Authorization", token);
    headers.add("Content-Type", "multipart/form-data;charset=UTF-8");//接口传参方式为form-data方式

    MultiValueMap<String, String> map = new LinkedMultiValueMap<String, String>();
    String json = JSONUtil.toJsonStr(defaultParams(params));
    map.add("params", json);
    HttpEntity<Object> httpEntity = new HttpEntity<Object>(map, headers);
    //String urlParams = url + "?params={json}";
    ResponseEntity<String> responseEntity = restTemplate.exchange(url, HttpMethod.POST, httpEntity, String.class);
    return JSON.parseObject(responseEntity.getBody()).getJSONObject("status").getInteger("code");
}

总结

最终原因是没有搞清楚接口的参数到底是怎么传递的,先通过postman测试,找到参数的正确传递方式,再通过代码调试