package io.apibuilder.api.v0.models;

import java.lang.Long;
import java.lang.String;
import java.lang.Void;
import java.util.UUID;
import retrofit2.Call;
import retrofit2.http.Body;
import retrofit2.http.DELETE;
import retrofit2.http.GET;
import retrofit2.http.POST;
import retrofit2.http.Path;
import retrofit2.http.Query;

/**
 * Generated by API Builder - https://www.apibuilder.io
 * Service version: 0.12.14
 * User agent: apibuilder app.apibuilder.io/apicollective/apibuilder-api/0.12.14/android_client
 *
 * WARNING: not all features (notably unions) and data types work with android generator yet.  
 * Android generator is designed to be used in an android application, but should work in any java codebase as long as you import jackson and retrofit2 libraries.  
 * If you are considering using this library, would like to request/discuss features, or would like to share how you're using it, please contact android-feedback@gilt.com 
 *
 */
public interface SubscriptionsClient {
  /**
   * Search subscriptions. Always paginated.
   */
  @GET("subscriptions")
  Call<Subscription[]> getSubscriptions(@Query("guid") UUID guid,
      @Query("organization_key") String organizationKey, @Query("user_guid") UUID userGuid,
      @Query("publication") Publication publication, @Query("limit") Long limit,
      @Query("offset") Long offset);

  /**
   * Returns information about a specific subscription.
   */
  @GET("subscriptions/{guid}")
  Call<Subscription> getSubscriptionsGuid(@Path("guid") UUID guid);

  /**
   * Create a new subscription.
   */
  @POST("subscriptions")
  Call<Subscription> postSubscriptions(@Body SubscriptionForm subscriptionForm);

  @DELETE("subscriptions/{guid}")
  Call<Void> deleteSubscriptionsGuid(@Path("guid") UUID guid);
}