ASPinboard is the Objective-C library for Pinboard that powers Pushpin. It uses modern Objective-C features (such as ARC and blocks), supports iOS 5.1+, and is dead-simple to integrate. As of January 2013, ASPinboard has full support for every endpoint in the Pinboard API, except posts/recent.
The first thing you'll want to do is add the files in the ASPinboard directory to your application. Alternatively, you can drag and drop the Xcode project into your existing app, and create a workspace. It's really up to you.
ASPinboard uses the Pinboard's authentication token to access protected resources. You can retrieve a token with the authenticateWithUsername:password:success:failure method.
void (^loginFailureBlock)(NSError *);
loginFailureBlock = ^(NSError *error) {
if (error.code == PinboardErrorInvalidCredentials) {
// An invalid username or password was provided.
}
else if (error.code == PinboardErrorTimeout) {
// The authentication request will time out if
// it takes longer than 20 seconds to respond.
}
};
ASPinboard *pinboard = [ASPinboard sharedInstance];
[pinboard authenticateWithUsername:PINBOARD_USERNAME
password:PINBOARD_PASSWORD
success:^(NSString *token) {
NSLog(@"Your Pinboard API token is: %@", token);
}
failure:loginFailureBlock];After authenticating, ASPinboard stores the token internally for future requests.
If you want to use a token that you've previously stored or copied from your settings page, just use the setToken method on the ASPinboard shared instance before using ASPinboard to make requests to protected resources.
[pinboard setToken:token];Now that you have a token, let's grab your bookmarks, shall we?
void (^successBlock)(NSArray *);
successBlock = ^(NSArray *bookmarks) {
NSLog(@"Here are your bookmarks:");
for (id bookmark in bookmarks) {
NSLog(@"url: %@", bookmark[@"href"]);
}
};
void (^failureBlock)(NSError *);
failureBlock = ^(NSError *error) {
if (error != nil) {
NSLog(@"Houston, we have a problem.");
}
};
[pinboard bookmarksWithSuccess:successBlock failure:failureBlock];[pinboard addBookmarkWithURL:@"https://pinboard.in/"
title:@"Pinboard"
description:@"A cool bookmarking site"
tags:@"bookmarking services"
shared:YES
unread:NO
success:^{}
failure:failureBlock];This method can also be used to update an existing bookmark. For more information, see the Pinboard documentation for posts/add.
Please see ASPinboard.h for the full list of supported methods.
ASPinboard is available for use under the Apache License, Version 2.0. See LICENSE for more details.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent