使用

Embedly iOS 库为您提供对 Embedly 所有 API 的访问，但有两种与 API 交互的不同方法

• Embed、Extract 和旧版 API 通过 call{EmbedlyApi,Embed,Extract,...} 方法提供，这些方法初始化 HTTP 调用，完成时通过相应的代理方法 (embedly{Success,Failure}) 通知。

• Display API 则不同。build{DisplayUrl,CroppedImageUrl,...} 方法仅仅返回一个包含通过 Embedly Display API 处理后的图片 URL 的 NSString。您可以在任何使用其他图像地址的地方使用此 URL（例如，AFNetworking+UIImage）。

call{EmbedlyApi,Embed,...} 方法使用委派来返回 API 调用的结果，因此您的代码需要实现 EmbedlyDelegate 协议。API 响应在 'response' 中返回，可以作为一个 NSDictionary 访问。

为了简化在您的应用内缓存 API 调用，call{EmbedlyApi,Embed,...} 函数返回一个包含完整的 Embedly API 调用的字符串。您可以将此用作存储 API 响应的键（例如，在一个 NSDictionary 中）。此返回值也有助于调试 API 调用。

为了进行批处理 API 调用（同时处理多个 URL），您可以使用 callEmbedlyApi:withUrls:params: 方法，它接受一个 NSStrings 的 NSArray。在这种情况下，返回到 'response' 中的 API 响应可以作为 NSDictionarys 的 NSArray 访问。

要求

Embedly 的所有产品均可免费使用，只需在上签约 API 密钥即可

https://app.embed.ly/signup

请确保在初始化 Embedly 对象时包含您的 API 密钥。

如果您的应用表现良好并且需要更多使用，您可以在以下网址了解更多关于我们的计划：

http://embed.ly/api

安装

要运行示例项目；克隆仓库，然后首先从 Example 目录中运行 pod install。您需要将您的 Embedly API 密钥添加到 initWithKey:delegate: 方法中（将 "mykey" 替换为您的 API 密钥）。

作者

@embedly

许可证

embedly-ios 在 MIT 许可下可用。有关更多信息，请参阅 LICENSE 文件。