Ebblink

iOS SDK to share JPEG images with an expiration date

Programming language: Objective-C

License: GNU General Public License v3.0 or later

Tags: Media     Image    

README

Ebblink iOS SDK

A library to integrate Ebblink private image sharing capabilities into your iOS app.

Table of Contents

Getting Started

1. Requirements
2. Setup
3. Quick Start
4. Terms and Conditions

Requirements

• iOS 8+

Setup

Add the following to your Podfile:

pod 'ebblinkSDK', :git => 'https://github.com/ebbapp/ebblinkSDK'

Quick Start

Instantiate Ebblink iOS SDK

To get a token send us email at [email protected]

The userId is a parameter that identifies a unique user. You can use any string such that the identifier is unique, for example the user email.

+ (void)initWithToken:(NSString*)token andUserId:(NSString*)userId;

Set processing mode

There are two possible processing modes:

• Device: the encryption and decryption of the image is performed on the user's device. This means that the image is uploaded to our servers fully encrypted.
• Server: the encryption and decryption of the image is performed on our server. This means that during the network data transfer from our servers to the device the image is not encrypted. The processing time may vary depending on the device specifications. By default the processing mode is Device. ```Objective-C

• (void)setProcessingMode:(EBProcessingMode)processingMode; ```

Upload a new image

+ (void) p3ImageUpload:(UIImage*)image duration:(NSNumber*) duration completion:(void (^)(NSString* imageId, NSString* password, NSString* publicLink, NSString* error))completionBlock;

View shared image

+ (void) p3ImageView:(NSString*)imageId withPassword:(NSString*)password completion:(void (^)(UIImage* image, NSString* error))completionBlock;

Check image status

+ (void) p3ImageStatus:(NSString*)imageId completion:(void (^)(NSDictionary* dictionary, NSString* error))completionBlock;

Delete image shared image

+ (void) p3ImageKill:(NSString*)imageId completion:(void (^)(BOOL success, NSString* error))completionBlock;

Upload an image as a story

A story is an image that is linked to the user and available for only 24h from the moment it is uploaded. The completion block returns an imageId that is needed if one wants to manually delete the image before the 24h.

+ (void) p3ImageStoryUpload:(UIImage*)image completion:(void (^)(NSString* imageId, NSString* error))completionBlock;

View the stories of a user

Calling this method and passing a userId will return in the completion block an EBUserStory object that contains all the available stories from that user.

+ (void) p3UserStoryView:(NSString*)userId completion:(void (^)(EBUserStory *story, NSString* error))completionBlock;;

Terms and Conditions

You can find our terms and conditions in the following url:

http://www.fiveopenbooks.com/terms