java API接口如何调用

在 Java 中，“调用 API 接口”通常指的是调用远程 HTTP 接口（RESTful / WebService 等）。下面从常见方式 + 示例给你一个完整说明。

一、常见调用方式概览

二、使用 HttpURLConnection（JDK 原生）

GET 请求示例

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class ApiTest {
    public static void main(String[] args) throws Exception {
        URL url = new URL("https://api.example.com/user/1");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");

        BufferedReader reader =
            new BufferedReader(new InputStreamReader(conn.getInputStream()));
        String line;
        StringBuilder result = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            result.append(line);
        }
        reader.close();

        System.out.println(result);
    }
}

三、使用 Apache HttpClient（推荐）

Maven 依赖

<dependency>
  <groupId>org.apache.httpcomponents</groupId>
  <artifactId>httpclient</artifactId>
  <version>4.5.13</version>
</dependency>

GET 示例

CloseableHttpClient client = HttpClients.createDefault();
HttpGet get = new HttpGet("https://api.example.com/user/1");
CloseableHttpResponse response = client.execute(get);

String result = EntityUtils.toString(response.getEntity());
System.out.println(result);

四、使用 OkHttp（非常流行）

依赖

<dependency>
  <groupId>com.squareup.okhttp3</groupId>
  <artifactId>okhttp</artifactId>
  <version>4.11.0</version>
</dependency>

示例

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
        .url("https://api.example.com/user/1")
        .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

五、Spring 项目（RestTemplate）

@RestController
public class TestController {

    @Autowired
    RestTemplate restTemplate;

    @GetMapping("/test")
    public String test() {
        return restTemplate.getForObject(
            "https://api.example.com/user/1", String.class);
    }
}

六、带参数 / POST 请求示例（OkHttp）

RequestBody body = RequestBody.create(
    MediaType.parse("application/json"),
    "{\"name\":\"tom\"}"
);

Request request = new Request.Builder()
        .url("https://api.example.com/user")
        .post(body)
        .addHeader("Authorization", "Bearer token")
        .build();

七、常见注意事项

✅ 设置超时
✅ 处理 HTTPS 证书
✅ JSON 解析（Jackson / Gson）
✅ 异常重试
✅ 接口鉴权（Token / Sign）

八、如果你愿意，我可以进一步帮你

你可以告诉我：

• 是 调用第三方 API 还是 写自己的接口？
• 用的是 Spring Boot 吗？
• 需要 GET / POST / 文件上传？

我可以直接给你可运行代码模板。