一、接口实例

public interface MainApi {
    /**
     * [@Headers 添加固定头部信息]
     *
     * @param timestamp @Header 添加动态头部信息
     * @param id        @Path {占位符}
     * @param time      @Query添加url请求参数
     * @param params    @QueryMap添加url请求参数
     * @return
     */
    @Headers({"Cache-Control: public, max-age=60"})
    @GET("article/list/{id}/json")
    Observable<MainDataBean> getMainData(@Header("timestamp") String timestamp, @Path("id") int id, @Query("time") String time, @QueryMap Map<String, String> params);

    /**
     * [@Url 注解与BaseURL关系]
     *
     * @param url 1、在注解中提供的url是完整的url，则url将作为请求的url
     *            2、在注解中提供的url是不完整的url，且不以 / 开头，则请求的url为baseUrl+注解中提供的值
     *            3、在注解中提供的url是不完整的url，且以 / 开头，则请求的url为baseUrl的主机部分+注解中提供的值
     * @return
     */
    @GET
    Observable<Response<Void>> getUrlData(@Url String url);

    /**
     * @param registerParamBean @Body GSON格式的Body体
     * @return
     */
    @POST("user/register")
    Observable<Response<Void>> postRegister(@Body RegisterParamBean registerParamBean);

    /**
     * @param params @FieldMap 表单格式的Body体--配合 @FormUrlEncoded使用
     * @return
     */
    @FormUrlEncoded
    @POST("user/register")
    Observable<RegistResponseBean> postRegister(@FieldMap Map<String, String> params);

    /**
     * @param params @FieldMap 表单格式的Body体--配合 @FormUrlEncoded使用
     * @return
     */
    @FormUrlEncoded
    @POST("user/login")
    Observable<LoginResponseBean> postLogin(@FieldMap Map<String, String> params);

    /**
     * @param username@Field 表单格式的Body体--配合 @FormUrlEncoded使用
     * @param password@Field 表单格式的Body体--配合 @FormUrlEncoded使用
     * @param nick@Query     添加URL上请求参数   @Query与@Field区别：@Query是把参数添加到URL后面，而@Field则是Body里面
     * @return
     */
    @FormUrlEncoded
    @POST("user/login")
    Observable<LoginResponseBean> postLogin(@Field("username") String username, @Field("password") String password, @Query("nick") String nick);

}