PinterestSDK for iOS

iOS 的 PinterestSDK 允许您验证 Pinterest 账户并代表已验证用户发出请求。有关支持的端点详细信息，请访问 Pinterest API。

安装

PinterestSDK 是一个 Cocoapod。为了使用它，您可能需要创建一个 Podfile（如果您还没有的话）。有关安装 Cocoapods 和创建 Podfile 的信息，请参阅 Cocoapods.org。（提示：要安装 Cocoapods，请从命令行运行 sudo gem install cocoapods；要创建 Podfile，请运行 pod init）。

打开 Podfile 并添加以下依赖项

pod "PinterestSDK", :git => "[email protected]:pinterest/ios-pdk.git"

保存您的 Podfile 并从命令行运行 'pod install'。

您还可以尝试使用示例应用程序

pod try https://github.com/pinterest/ios-pdk.git

设置您的应用程序

注册您的应用程序

访问 Pinterest 开发者网站 并注册您的应用程序。这将为您生成一个 appId，您将在下一步中需要它。请确保添加您的重定向 URI。对于 iOS，您的重定向 URI 将是 pdk[你的-appId]。例如，如果您的 appId 是 1234，您的重定向 URI 将是 pdk1234。

配置 Xcode

PinterestSDK 将使用 OAuth 通过 Pinterest 应用或 Safari（如果未安装 Pinterest 应用）进行验证。为了在验证后重定向回您的应用程序，您需要进行自定义 URL 方案。为此，请进入您应用程序的 plist 并添加一个名为 pdk[你的-appId] 的 URL 方案。

配置 PDKClient

在您应用程序中调用 PDKClient 之前，您需要用您的 appId 配置它

[PDKClient configureSharedInstanceWithAppId:@"12345"];

在 application:didFinishLaunchingWithOptions: 的末尾似乎是一个合理的地点。

验证

验证用户时，请在 PDKClient 上调用 authenticateWithPermissions:withSuccess:andFailure:。如果当前的认证令牌无效或这是您第一次请求令牌，将会导致应用切换至 Pinterest 应用或 Safari。为了处理切换回您的应用，按照以下方式实现您的应用的这个方法：application:openURL:sourceApplication:annotation:

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
return [[PDKClient sharedInstance] handleCallbackURL:url];
}

对于 iOS9 及更高版本，application:openURL:sourceApplication:annotation: 已弃用，因此您应该按照以下方式实现 application:openURL:options:

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options
{
return [[PDKClient sharedInstance] handleCallbackURL:url];
}

示例应用

开始探索 PDK 的一个好地方是示例应用。要运行它，请浏览到 Example 目录并执行 pod install。接下来在 XCode 中打开 PinterestSDK.xcworkspace 并运行。

文档

要获取完整文档及有关 Pinterest 开发者平台更多信息，请访问

PinterestSDK for iOS

Pinterest API 文档

Pinterest API 注册