一、前言
Java请求第三方接口的一些步骤。
在Java中请求第三方接口通常涉及以下步骤。这些步骤涵盖了从准备请求到处理响应的整个过程。
1. 确定接口详情
- 接口URL:你要请求的URL。
- 请求方法:如GET、POST、PUT、DELETE等。
- 请求参数:包括URL参数、请求体参数、请求头参数等。
- 响应格式:如JSON、XML等。
2. 添加依赖
如果你使用的是Maven或Gradle等构建工具,你可能需要添加HTTP客户端库的依赖。例如,你可以使用Apache HttpClient、OkHttp、Retrofit等。
3. 创建请求
- 创建一个
HttpURLConnection
对象(或其他HTTP客户端库的实例)。 - 设置请求方法(如
HttpURLConnection.setRequestMethod("POST")
)。 - 如果需要,设置请求头(如Content-Type、Authorization等)。
- 如果请求有请求体(如POST请求),设置请求体的内容。
4. 发送请求并获取响应
- 调用HTTP客户端的发送请求方法(如
HttpURLConnection.connect()
)。 - 读取响应状态码和响应头。
- 读取响应体内容(如JSON字符串)。
5. 处理响应
- 根据响应状态码判断请求是否成功。
- 解析响应体内容(如将JSON字符串解析为Java对象)。
- 处理异常或错误情况。
二、获取接口文档(示例)
POST请求报文体是如下请求参数组成的JSON报文
响应报文体是如下响应参数组成JSON报文
请求参数格式
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
sign_method | String(32) | 是 | 签名摘要算法。目前只支持:MD5。 |
auth_code | String(32) | 是 | 授权码。商家授权应用访问的凭证。 示例值: VlERCP4fZzHzqK7vnr8weOYqepkXriKL |
timestamp | String(19) | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8。 越洋电铺API服务端允许该时间戳与当前时间最大误差为10分钟。 示例值:2017-01-01 12:00:00 |
sign | String(32) | 是 | API输入参数签名结果,签名算法介绍签名算法。 示例值: A950EEDA1342BBDB83AB8C79B759BE44 |
nonce_str | String(32) | 是 | 随机字符串,长度要求在32位以内。建议每笔请求传入一个随机字符串 示例值: 3g3jJVfI9CWwKMr45x9SkB0gbi9kAn28 |
biz_content | String | 是 | 请求的业务参数组成的JSON字符串,请至请求详情页查看每个请求的具体业务参数定义。 示例值: {"sku_stocks":[{"outer_sku_id":"393992","stock_num":10},{"outer_sku_id":"393993","stock_num":12}]} |
响应参数格式
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
code | String(16) | 是 | 响应码。请至各请求详情页查看请求有无公共返回码之外的业务返回码 | 0000 |
message | String(128) | 否 | 响应码描述 | |
content | json object | 否 | 返回业务数据,具体内容由各个api确定 |
- 公共返回码
返回码 | 描述 |
---|---|
0000 | 成功 |
0001 | 非法参数 |
0002 | 非法授权码 |
0003 | 非法请求时间 |
0004 | 验签失败 |
0005 | 非法api名称 |
0006 | 业务请求参数JSON格式不正确 |
0007 | 短时间请求过多 |
0009 | 处理失败,请稍后重试 |
签名算法
签名生成的通用步骤如下
- 第一步,设所有发送的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序(字典序),使用URL查询参数键值对的格式(即key1=value1&key2=value2…)拼接成字符串stringA。
特别注意以下重要规则
- 参数名ASCII码从小到大排序(字典序);
- 如果参数的值为空不参与签名;
- 参数名区分大小写 ;
- 请求url中的app_id和method参数也参与签名
- 请求报文体内的sign参数不参与签名
例如将foo=1,bar=2,baz=3 排序为bar=2,baz=3,foo=1, 参数名和参数值链接后,得到拼装字符串bar=2&baz=3&=foo1
- 第二步,在stringA最后拼接上&app_secret=${appSecret}得到stringSignTemp字符串,并对stringSignTemp进行MD5运算,再将得到的字符串所有字符转换为大写,得到sign值signValue。
三、签名,参数
/**
*
* 组装请求签名信息
*
* @return
*/
private HashMap<String, String> getResModelSign(String biz_content) {
String signMethod = "MD5";
// 时间戳
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String timestamp = sdf.format(new sunbox.core.util.Date());
// 随机数
String nonceStr = Utility.randomString(6, 1);
HashMap<String, String> bodyMap = new HashMap<>();
bodyMap.put("app_id", appId);
bodyMap.put("app_secret", appSecret);
bodyMap.put("method", method);
bodyMap.put("sign_method", signMethod);
bodyMap.put("timestamp", timestamp);
bodyMap.put("nonce_str", nonceStr);
bodyMap.put("auth_code", authCode);
bodyMap.put("biz_content", biz_content);
String signStr = "app_id=" + appId + "&" + "auth_code=" + authCode + "&" + "biz_content=" + biz_content + "&"
+ "method=" + method + "&" + "nonce_str=" + nonceStr + "&" + "sign_method=" + signMethod + "&"
+ "timestamp=" + timestamp + "&" + "app_secret=" + appSecret;
String sign = CtgSignUtil.MD5(signStr).toUpperCase();
bodyMap.put("sign", sign);
return bodyMap;
}
四、开发调试
public static String doPost(String url, String content, String contentType
, int connTimeOut, int readTimeOut, Map<String, String> reqHead) throws Exception {
CloseableHttpClient httpClient = null;
CloseableHttpResponse httpResponse = null;
String result = "";
// 创建httpClient实例
httpClient = HttpClients.createDefault();
// 创建httpPost远程连接实例
HttpPost httpPost = new HttpPost(url);
// 配置请求参数实例
RequestConfig requestConfig = RequestConfig.custom().setConnectTimeout(connTimeOut)// 设置连接主机服务超时时间
.setConnectionRequestTimeout(connTimeOut)// 设置连接请求超时时间
.setSocketTimeout(readTimeOut)// 设置读取数据连接超时时间
.setProxy(httpClientProxy)
.build();
// 为httpPost实例设置配置
httpPost.setConfig(requestConfig);
// 设置请求头
httpPost.addHeader("Content-Type", contentType);
// httpPost.addHeader("Content-Length", String.valueOf(content.length()));
if (reqHead != null) {
for (Map.Entry<String, String> entry : reqHead.entrySet()) {
if (StringUtils.isNotBlank(entry.getValue())) {
httpPost.addHeader(entry.getKey(), entry.getValue());
}
}
}
// 封装post请求参数
if (null != content) {
// 为httpPost设置封装好的请求参数
byte[] b = content.getBytes(StandardCharsets.UTF_8);
InputStream is = new ByteArrayInputStream(b, 0, b.length);
httpPost.setEntity(new InputStreamEntity(is, b.length
, ContentType.create(contentType, StandardCharsets.UTF_8)));
}
try {
// httpClient对象执行post请求,并返回响应参数对象
httpResponse = httpClient.execute(httpPost);
// 从响应对象中获取响应内容
HttpEntity entity = httpResponse.getEntity();
result = EntityUtils.toString(entity, "UTF-8");
if (httpResponse.getStatusLine().getStatusCode() != 200) {
throw new Exception(result);
}
} catch (ClientProtocolException e) {
throw e;
} catch (IOException e) {
throw e;
} finally {
// 关闭资源
if (null != httpResponse) {
try {
httpResponse.close();
} catch (IOException e) {
throw e;
}
}
if (null != httpClient) {
try {
httpClient.close();
} catch (IOException e) {
throw e;
}
}
}
return result;
}