fullcontact / sdk
Full Contacts API 的 PHP 封装
Requires
- php: >=5.2.1
Requires (Dev)
- mockery/mockery: >=0.7.2
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
除非适用法律要求或书面同意,否则根据许可证分发的软件按“现状”提供,不提供任何明示或暗示的保证或条件。有关许可证的具体语言管辖权限和限制,请参阅许可证。