Full Contacts API 的 PHP 封装

v0.2.1 2018-11-27 16:21 UTC

This package is not auto-updated.

Last update: 2024-09-14 16:24:15 UTC


README

这是 FullContact API 的 PHP 辅助工具 - http://www.fullcontact.com/

它是基于 Twilio PHP 辅助库的,因为我认为它做得很好,考虑得很周到。这不是官方版本,但应该可以正常工作,除非以下 TODO 列表中的不完整项目。

这是 v0.9.0 版本,所以它相当稳定,我不认为接口会有很大变化。

要求

这假设您已安装 cURL 及其对应的 php-curl 接口。它可以扩展以支持其他 HTTP 传输工具,但我有点懒惰。

入门

您必须有 FullContact 账户。然后复制 creds-dist.php 文件到 creds.php 并填写 API 密钥。然后您应该能够直接运行 /examples 目录中的任何脚本。

代码本身很简单。您使用 API 密钥初始化选定的对象,然后继续。

$this->name = new Services_FullContact_Name($apikey);

测试

这是使用基本的 PHPUnit 配置设置的。我使用了 3.7.8 版本,但这不应该有任何区别。从项目根目录,您应该能够执行测试,使用:

phpunit tests/

TODO

这个库尚不完整,以下是活动的 TODO 列表。

  • 对于 Person 资源
  • 实现通过电子邮件和 emailMD5 查找
  • 实现输出样式(仅通过电子邮件查找)
  • 实现通过电话查找
  • 实现 countryCode 以支持非 US/Canada 电话号码
  • 实现通过 Twitter 查找
  • 实现通过 vCard 查找
  • 实现基于队列的处理的队列和回调
  • 实现 webhookUrl 和 webhookId 以支持异步处理--
  • 实现 css 和 prettyPrint 以支持输出
  • 实现增强查找检索
  • 对于 Name 资源
  • 实现具有大小写的标准化
  • 实现使用电子邮件或用户名进行大小写敏感的推导
  • 实现大小写敏感的相似度
  • 实现具有大小写的统计信息,使用 name, givenName, familyName, 和两者(givenName 和 familyName)
  • 实现具有大小写的解析器
  • 对于 Location 资源
  • 实现使用 includeZeroPopulation 和大小写进行标准化
  • 实现使用 includeZeroPopulation 和大小写进行丰富
  • 对于 Icon 资源
  • 实现获取所有可用图标的方法
  • 实现使用大小和类型检索图标
  • 实现 CardShark 资源
  • 实现检测可抛弃电子邮件地址
  • 实现检索账户统计信息
  • 更新库以与之前的官方版本向后兼容
  • 更新测试以使用 Mocks 代替实时 API 调用.. 因为它可能会耗尽您的账户积分。哎。

许可

包含的所有代码均受 Apache 许可证。

版权 (C) 2013, FullContact 及贡献者

根据 Apache 许可证版本 2.0(“许可证”)许可;除非法律要求或书面同意,否则不得使用此文件,除非符合许可证。您可以在以下位置获得许可证副本:

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意,否则根据许可证分发的软件按“现状”提供,不提供任何明示或暗示的保证或条件。有关许可证的具体语言管辖权限和限制,请参阅许可证。