使用Retrofit时如何添加请求头？RapidAPI健身API集成求助

是否有必要用Retrofit？ #

• 如果你已经熟悉Retrofit的用法，完全可以用它来实现。Retrofit基于OkHttp封装，更适合结构化的API请求，代码更简洁易维护，尤其是需要多次调用API的场景。
• 如果只是简单调用一两次API，直接用平台提供的OkHttp代码片段也可行，学习成本更低。

用Retrofit实现的步骤 #

1. 添加依赖（以Gradle项目为例） #

// Retrofit核心库
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
// Gson转换器（用于解析JSON响应）
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

2. 定义API接口 #

根据你要调用的具体API端点，创建对应的接口：

import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Header;
import retrofit2.http.Query;

public interface FitnessApi {
    // 替换为RapidAPI提供的具体接口路径
    @GET("trainings")
    Call<TrainingResponse> getTrainingPlans(
        @Header("X-RapidAPI-Key") String apiKey,
        @Header("X-RapidAPI-Host") String apiHost,
        // 按需添加接口要求的查询参数，比如训练类型、难度
        @Query("type") String trainingType,
        @Query("difficulty") String difficulty
    );
}

注：TrainingResponse是你根据API返回的JSON结构创建的实体类，可借助GsonFormat等工具自动生成。

3. 创建Retrofit实例并发起请求 #

import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;

public class FitnessApiClient {
    private static final String BASE_URL = "https://your-api-host.p.rapidapi.com/"; // 替换为RapidAPI提供的基础URL
    private static Retrofit retrofit;

    public static FitnessApi getApiService() {
        if (retrofit == null) {
            retrofit = new Retrofit.Builder()
                .baseUrl(BASE_URL)
                .addConverterFactory(GsonConverterFactory.create())
                .build();
        }
        return retrofit.create(FitnessApi.class);
    }

    // 调用示例
    public static void fetchTrainings() {
        FitnessApi apiService = getApiService();
        String apiKey = "your-rapidapi-key";
        String apiHost = "your-api-host.p.rapidapi.com";

        Call<TrainingResponse> call = apiService.getTrainingPlans(apiKey, apiHost, "strength", "beginner");
        call.enqueue(new retrofit2.Callback<TrainingResponse>() {
            @Override
            public void onResponse(Call<TrainingResponse> call, retrofit2.Response<TrainingResponse> response) {
                if (response.isSuccessful()) {
                    TrainingResponse data = response.body();
                    // 处理返回的训练数据
                } else {
                    // 处理请求失败（比如状态码非200）
                }
            }

            @Override
            public void onFailure(Call<TrainingResponse> call, Throwable t) {
                // 处理网络错误
            }
        });
    }
}

直接使用OkHttp的基础实现步骤 #

如果不想用Retrofit，直接用平台提供的OkHttp代码也很简单：

1. 添加依赖 #

implementation 'com.squareup.okhttp3:okhttp:4.10.0'

2. 编写请求代码（替换你的密钥和参数） #

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

import java.io.IOException;

public class OkHttpFitnessExample {
    public static void main(String[] args) throws IOException {
        OkHttpClient client = new OkHttpClient();

        Request request = new Request.Builder()
            .url("https://your-api-host.p.rapidapi.com/trainings?type=strength&difficulty=beginner")
            .get()
            .addHeader("X-RapidAPI-Key", "your-rapidapi-key")
            .addHeader("X-RapidAPI-Host", "your-api-host.p.rapidapi.com")
            .build();

        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("请求失败，状态码：" + response.code());

            String responseJson = response.body().string();
            // 解析并处理JSON字符串
        }
    }
}

注：Android环境下不能在主线程执行同步请求，需改用enqueue异步调用。

内容的提问来源于stack exchange，提问作者user19595313