com.bynder.sdk.api

Interface BynderApi

public interface BynderApi

Interface of the Bynder API to handle the HTTP communication.

Method Summary

Modifier and Type	Method and Description
io.reactivex.Observable<retrofit2.Response<FinaliseResponse>>	finaliseUpload(Map<String,String> params) Finalises a completely uploaded file.
io.reactivex.Observable<retrofit2.Response<String>>	getAccessToken() Gets a temporary access token pair once the user already authorised the request token pair.
io.reactivex.Observable<retrofit2.Response<List<Brand>>>	getBrands() Gets list of the brands.
io.reactivex.Observable<retrofit2.Response<String>>	getClosestS3Endpoint() Gets the URL of the Amazon S3 bucket-endpoint in the region closest to the server.
io.reactivex.Observable<retrofit2.Response<DownloadUrl>>	getMediaDownloadUrl(String mediaId) Gets the download file URL for a specific media id.
io.reactivex.Observable<retrofit2.Response<DownloadUrl>>	getMediaDownloadUrl(String mediaId, String mediaItemId) Gets the download file URL for specific media item id.
io.reactivex.Observable<retrofit2.Response<Media>>	getMediaInfo(Map<String,String> params) Gets all the media information for a specific media id.
io.reactivex.Observable<retrofit2.Response<List<Media>>>	getMediaList(Map<String,String> params) Gets a list of media assets filtered by parameters.
io.reactivex.Observable<retrofit2.Response<Map<String,Metaproperty>>>	getMetaproperties(Map<String,String> params) Gets map of the metaproperties.
io.reactivex.Observable<retrofit2.Response<PollStatus>>	getPollStatus(Map<String,String> params) Gets poll processing status of finalised files.
io.reactivex.Observable<retrofit2.Response<String>>	getRequestToken() Gets temporary request token pair.
io.reactivex.Observable<retrofit2.Response<List<Tag>>>	getTags() Gets list of the tags.
io.reactivex.Observable<retrofit2.Response<UploadRequest>>	getUploadInformation(Map<String,String> params) Initialises a file upload with Bynder and returns authorisation information to allow uploading to the Amazon S3 bucket-endpoint.
io.reactivex.Observable<retrofit2.Response<User>>	login(Map<String,String> params) Logs in to Bynder with a username and password pair.
io.reactivex.Observable<retrofit2.Response<Void>>	registerChunk(Map<String,String> params) Registers an uploaded chunk in Bynder.
io.reactivex.Observable<retrofit2.Response<SaveMediaResponse>>	saveMedia(Map<String,String> params) Saves a new media asset in Bynder.
io.reactivex.Observable<retrofit2.Response<Void>>	setMediaProperties(Map<String,String> params) Updates the media properties (metadata) for a specific media id.

Method Detail

login

@FormUrlEncoded
 @POST(value="/api/v4/users/login/")
io.reactivex.Observable<retrofit2.Response<User>> login(@FieldMap
                                                                                                             Map<String,String> params)

Logs in to Bynder with a username and password pair.

Parameters:

params - FieldMap with parameters.

Returns:

Observable with the User information.

getRequestToken

@POST(value="/api/v4/oauth/request_token/")
io.reactivex.Observable<retrofit2.Response<String>> getRequestToken()

Gets temporary request token pair.

Returns:

Observable with the request token pair information.

getAccessToken

@POST(value="/api/v4/oauth/access_token/")
io.reactivex.Observable<retrofit2.Response<String>> getAccessToken()

Gets a temporary access token pair once the user already authorised the request token pair. If successful the request token pair is immediately expired.

Returns:

Observable with the access token pair information.

getBrands

@GET(value="/api/v4/brands/")
io.reactivex.Observable<retrofit2.Response<List<Brand>>> getBrands()

Gets list of the brands.

Returns:

Observable with list of Brand.

getTags

@GET(value="/api/v4/tags/")
io.reactivex.Observable<retrofit2.Response<List<Tag>>> getTags()

Gets list of the tags.

Returns:

Observable with list of Tag.

getMetaproperties

@GET(value="/api/v4/metaproperties/")
io.reactivex.Observable<retrofit2.Response<Map<String,Metaproperty>>> getMetaproperties(@QueryMap
                                                                                                                              Map<String,String> params)

Gets map of the metaproperties. The key of the map returned is the name of the metaproperty.

Parameters:

params - QueryMap with parameters.

Returns:

Observable with Map of metaproperties.

getMediaList

@GET(value="/api/v4/media/")
io.reactivex.Observable<retrofit2.Response<List<Media>>> getMediaList(@QueryMap
                                                                                                   Map<String,String> params)

Gets a list of media assets filtered by parameters.

Parameters:

params - QueryMap with parameters.

Returns:

Observable with list of Media.

getMediaInfo

@GET(value="/api/v4/media/")
io.reactivex.Observable<retrofit2.Response<Media>> getMediaInfo(@QueryMap
                                                                                             Map<String,String> params)

Gets all the media information for a specific media id.

Parameters:

params - QueryMap with parameters.

Returns:

Observable with Media information.

getMediaDownloadUrl

@GET(value="/api/v4/media/{id}/download/")
io.reactivex.Observable<retrofit2.Response<DownloadUrl>> getMediaDownloadUrl(@Path(value="id")
                                                                                                                        String mediaId)

Gets the download file URL for a specific media id.

Parameters:

mediaId - Media id of which we want to get the download URL.

Returns:

Observable with the DownloadUrl information of the media.

getMediaDownloadUrl

@GET(value="/api/v4/media/{id}/download/{itemId}/")
io.reactivex.Observable<retrofit2.Response<DownloadUrl>> getMediaDownloadUrl(@Path(value="id")
                                                                                                                                 String mediaId,
                                                                                                                                 @Path(value="itemId")
                                                                                                                                 String mediaItemId)

Gets the download file URL for specific media item id.

Parameters:

mediaId - Media id of which the media item belongs to.

mediaItemId - Media item id of which we want to get the download URL.

Returns:

Observable with the DownloadUrl information of the media item.

setMediaProperties

@FormUrlEncoded
 @POST(value="/api/v4/media/")
io.reactivex.Observable<retrofit2.Response<Void>> setMediaProperties(@FieldMap
                                                                                                                    Map<String,String> params)

Updates the media properties (metadata) for a specific media id.

Parameters:

params - FieldMap with parameters.

Returns:

Observable with the Response.

getUploadInformation

@FormUrlEncoded
 @POST(value="/api/upload/init/")
io.reactivex.Observable<retrofit2.Response<UploadRequest>> getUploadInformation(@FieldMap
                                                                                                                                  Map<String,String> params)

Initialises a file upload with Bynder and returns authorisation information to allow uploading to the Amazon S3 bucket-endpoint.

Parameters:

params - FieldMap with parameters.

Returns:

Observable with UploadRequest authorisation information.

getClosestS3Endpoint

@GET(value="/api/upload/endpoint/")
io.reactivex.Observable<retrofit2.Response<String>> getClosestS3Endpoint()

Gets the URL of the Amazon S3 bucket-endpoint in the region closest to the server. This URL is used to upload parts to Amazon.

Returns:

Observable with the URL.

registerChunk

@FormUrlEncoded
 @POST(value="/api/v4/upload/")
io.reactivex.Observable<retrofit2.Response<Void>> registerChunk(@FieldMap
                                                                                                                Map<String,String> params)

Registers an uploaded chunk in Bynder.

Parameters:

params - FieldMap with parameters.

Returns:

Observable with the Response.

finaliseUpload

@FormUrlEncoded
 @POST(value="/api/v4/upload/")
io.reactivex.Observable<retrofit2.Response<FinaliseResponse>> finaliseUpload(@FieldMap
                                                                                                                             Map<String,String> params)

Finalises a completely uploaded file.

Parameters:

params - FieldMap with parameters.

Returns:

Observable with FinaliseResponse information.

getPollStatus

@GET(value="/api/v4/upload/poll/")
io.reactivex.Observable<retrofit2.Response<PollStatus>> getPollStatus(@QueryMap
                                                                                                         Map<String,String> params)

Gets poll processing status of finalised files.

Parameters:

params - QueryMap with parameters.

Returns:

Observable with PollStatus information.

saveMedia

@FormUrlEncoded
 @POST(value="/api/v4/media/save/")
io.reactivex.Observable<retrofit2.Response<SaveMediaResponse>> saveMedia(@FieldMap
                                                                                                                             Map<String,String> params)

Saves a new media asset in Bynder. If media id is specified in the query a new version of the asset will be saved. Otherwise a new asset will be saved.

Parameters:

params - FieldMap with parameters.

Returns:

Observable with the SaveMediaResponse information.