fullcontact-objc 1.0.1

fullcontact-objc 1.0.1

×

测试已测试✗
Lang语言 Obj-CObjective C
许可证 自定义
发布上次发布2014年12月

由 未申报 维护。

fullcontact-objc 1.0.1

  • 由
  • Duane Schleen

是否曾想从您自己的 iOS 或 OS X 应用程序中调用 FullContact 的 API？现在您可以了。

fullcontact-objc 是用于 iOS 和 Mac OS X 的库。它基于 AFNetworking 构建并提供对 FullContact 开发者 API 端点的连接。

为什么我们喜欢它…

fullcontact-objc 使您能够在 iOS 或 Mac OS X 应用程序中轻松访问 FullContact 开发者 API - 事实上，我们在我们自己的应用程序（如 FullContact Card Reader）中也使用它。

目前此库支持以下 FullContact 端点

端点 作用 文档 支持度
Person API 从一个电子邮件地址、电话号码、Twitter 密钥或 Facebook ID 返回社交配置文件数据 Person API FCAPI+Person.h
名称 API 从电子邮件地址或其他来源规范化、解析、比较和推断名称 名称 API FCAPI+Name.h
位置 API 规范化半结构化位置数据并提供相关信息 位置 API FCAPI+Location.h
卡读取器 API 从一个商业名片图片返回人工转录的结构化联系人数据 卡读取器 API FCAPI+CardReader.h
一次性电子邮件 API 检测一次性电子邮件地址和子地址电子邮件地址 一次性电子邮件 API FCAPI+Email.h
图标 API 通过 HTTPS 请求返回免费社交媒体图标 图标 API FCAPI+Icon.h
批量处理 API 将多个 API 请求合并为一个请求以改善性能 批量处理 API FCAPI+Batch.h
统计 API 查看和跟踪您的 FullContact API 账户使用情况 统计 API FCAPI+Stats.h

要求

fullcontact-objc 需要 iOS 5.0 或更高版本，或 Mac OS 10.7（64 位现代 Cocoa 运行时）或更高版本。

安装

CocoaPods 是将 fullcontact-objc 添加到项目的推荐方式。

  1. 将 fullcontact-objc 的 pod 条目添加到您的 Podfile 中 pod 'fullcontact-objc', '~> 1.0.0'
  2. 通过运行 pod install 安装 pod。
  3. 使用 #import "FCAPI.h" 或其子分类中的任何一项将其包含在任何需要的地方。

ARC

fullcontact-objc 使用自动引用计数（ARC）。

如果您的非ARC项目中使用了 fullcontact-objc，您需要在所有源文件上设置 -fobjc-arc 编译器标志。

要在 Xcode 中设置编译器标志，请转到您的活动目标并选择“构建阶段”选项卡。现在选择所有 fullcontact-objc 源文件，按 Enter 键，插入 -fobjc-arc，然后点击“完成”以启用 fullcontact-objc 的 ARC。

使用库

初始化 API

要初始化 API，只需导入 FCAPI.h。确保您已定义以下常量

  1. kAPIUrl 为 "https://api.fullcontact.com"
  2. kAPIVersion 为 "v2"
  3. kAPIKey 是您从 FullContact 获得的 API 密钥。

然后调用

FCAPI *api = [[FCAPI alloc] initWithBaseURL:[NSURL URLWithString:kAPIUrl] andVersion:kAPIVersion andAPIKey:kAPIKey];

调用 API

在初始化 API 之后，您可以简单地导入要使用的类别并调用其中一种方法。例如，如果您想通过电子邮件地址查找人员，可以这样做

将以下内容添加到您的导入中

#import "FCAPI+Person.h"

在初始化您的 API 实例之后，按以下方式调用 lookupByEmail 方法

[api lookupByEmail:@"[email protected]" success:^(FCResponse *response) {
      //response.response will contain your JSON payload which you can handle here
} 
failure:^(FCResponse *response, NSError *error) {
      //handle the error that may have been returned
}];

运行测试

要运行 fullcontact-objcTest，请简单地在 fullcontact-objcTest 项目中找到 TestConstants.h 文件并将您的 API 密钥作为 kAPIKey 的值插入。完成此操作后，您可以针对 iOS 和 OSX 架构运行测试。

请注意，卡读卡器测试当前仅在 iOS 平台上有效。

需要帮助 - 没问题！

我们随时乐意以任何方式帮助您。查看我们的 支持页面 以访问我们的知识库或联系我们的支持小组。

有什么想法吗？

我们喜欢想法！在 API 开发者论坛 上提交您的想法、建议或反馈，或分支我们的存储库。我们定期审查拉取请求，期待看到您的成果！

许可证

fullcontact-objc 在 Apache 许可证 Version 2.0 许可下提供。有关更多信息，请参阅 LICENSE 文件。

Bitdeli Badge