Giphy API client for iOS in Objective-C

alex choi

Last update: Jul 11, 2019

Related tags

Unofficial SDK Giphy-iOS

Overview

Giphy-iOS

Giphy-iOS is a Giphy API client for iOS in Objective-C.

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

You should read about Giphy's Access and API keys here.

Giphy-iOS / AXCGiphy

'AXCGiphy' provides convenient access to Giphy's API endpoints:

search
trending
translate
GIF by ID
GIFs by IDs

You can query the endpoints through the blocks based interface:

- (void)viewDidLoad
{
    [super viewDidLoad];
	// set your API key before making any requests. You may use kGiphyPublicAPIKey for development.
    [AXCGiphy setGiphyAPIKey:kGiphyPublicAPIKey];

    [AXCGiphy searchGiphyWithTerm:@"frogs" limit:10 offset:0 completion:^(NSArray *results, NSError *error) {
        self.giphyResults = results;
        [[NSOperationQueue mainQueue] addOperationWithBlock:^{
            [self.collectionView reloadData];
        }];
    }];
}


- (UICollectionViewCell *) collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath
{
    AXCCollectionViewCell * cell = [collectionView dequeueReusableCellWithReuseIdentifier:kCollectionViewCellIdentifier forIndexPath:indexPath];
    AXCGiphy * gif = self.giphyResults[indexPath.item];
    
    NSURLRequest * request = [NSURLRequest requestWithURL:gif.originalImage.url];
    [[[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        UIImage * image = [UIImage imageWithData:data];
        [[NSOperationQueue mainQueue] addOperationWithBlock:^{
            cell.imageView.image = image;
        }];
    }] resume];
    
    return cell;
}

AXCGiphy blocks based class methods provide asynchronous access to either AXCGiphy instances or an NSArray of AXCGiphy instances. AXCGiphy instances represent Giphy's gifs and their metadata. However, AXCGiphy only provides URLs to gifs. How you use these URLs is up to you.

My example uses NSURLRequests with NSURLSession to fetch the image data at the URLs and mattt's AnimatedGifSerialization to decode the animated GIFs into animated UIImages. If you are unsure of how to proceed, use my example app as a starting point.

The blocks based class methods return NSURLSessionDataTasks for additional control, should you need it.

AXCGiphy also provides class methods to generate NSURLRequests for these endpoints.

Requirements

AFNetworking/Serialization 2.3.1

Installation

Giphy-iOS is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "Giphy-iOS"
pod 'AFNetworking/Serialization', '~> 2.3.1'

Author

Alex Choi, [email protected]

License

Giphy-iOS is available under the MIT license. See the LICENSE file for more info.

You might also like...

An Elegant Spotify Web API Library Written in Swift for iOS and macOS

Written in Swift 4.2 Spartan is a lightweight, elegant, and easy to use Spotify Web API wrapper library for iOS and macOS written in Swift 3. Under th

107 Nov 8, 2022

Easy and powerful way to interact with VK API for iOS and macOS

Easy and powerful way to interact with VK API for iOS and macOS. Key features 😊 It's not ios-vk-sdk 😊 🍏 One library for iOS and mac OS 🍏 🤘 Fully

260 Dec 22, 2022

Twitter API for Cocoa developers

FHSTwitterEngine Twitter API for Cocoa developers Created by Nathaniel Symer FHSTwitterEngine can: Authenticate using OAuth and/or xAuth. Make a reque

213 Jul 8, 2022

Unified API Library for: Cloud Storage, Social Log-In, Social Interaction, Payment, Email, SMS, POIs, Video & Messaging.

Unified API Library for: Cloud Storage, Social Log-In, Social Interaction, Payment, Email, SMS, POIs, Video & Messaging. Included services are Dropbox, Google Drive, OneDrive, OneDrive for Business, Box, Egnyte, PayPal, Stripe, Google Places, Foursquare, Yelp, YouTube, Vimeo, Twitch, Facebook Messenger, Telegram, Line, Viber, Facebook, GitHub, Google+, LinkedIn, Slack, Twitter, Windows Live, Yahoo, Mailjet, Sendgrid, Twilio, Nexmo, Twizo.

195 Nov 29, 2021

Comments

Pod update fail

I think you can change the pod spec url from [email protected]:heyalexchoi/Giphy-iOS.git to https://github.com/heyalexchoi/Giphy-iOS.git, or people use you lib will get the fallowing error while installing the pod

[!] /usr/bin/git clone [email protected]:heyalexchoi/Giphy-iOS.git /Users/liyipeng/Library/Caches/CocoaPods/GitHub/6c18fae873774676144b1767c5a5be1f87355cad --mirror

Cloning into bare repository '/Users/liyipeng/Library/Caches/CocoaPods/GitHub/6c18fae873774676144b1767c5a5be1f87355cad'...

Permission denied (publickey).

thanks

opened by SummerTree 1
Facing memory leak

I have integrated your code in my project. Used collection view to load all gif but it is taking too much time to load the gif and after few minutes app is getting crashed. Can you please help me out to resolve this issue?

opened by igatishah 0
API won't return any data

I am use this code: Can't get any data,

[AXCGiphy searchGiphyWithTerm:@"frogs" limit:10 offset:0 completion:^(NSArray *results, NSError *error) { self.giphyResults = results; [[NSOperationQueue mainQueue] addOperationWithBlock:^{ [self.collectionView reloadData]; }]; }];

but api Can't get any data.

opened by brahmostech 0