验证 API 请求
在领英,我们重视会员数据的完整性和安全性胜于一切。如果您的应用想要访问领英会员的数据并/或代表他们采取行动,则必须获得验证。领英根据行业标准 OAuth 2.0 协议授予访问权限,而此协议实施起来十分简单、轻松。
请阅读使用 OAuth 2.0 验证指南,详细了解如何使应用获得验证并与领英 REST API 成功互动。
此外,开源社区中提供数个第三方库,它们以各种主要编程语言为您提炼 OAuth 2.0 验证流程的内容。
数据格式
如果您的应用更擅长处理 JSON 格式的数据,您可按照以下任一种方法请求 API 返回 JSON 数据:
- 在 API 调用结尾处添加一个 format=json 网址参数。
- 在 API 调用中添加此 HTTP 标头: x-li-format: json
向 API 发送数据
某些 API 调用 (例如与领英分享) 要求您在 API 调用期间以特定格式发送数据。默认情况下,所有 API 调用需采用 XML 格式输入。但是如果应用提交 JSON 格式的数据更为方便,则您可在调用请求中添加以下两个 HTTP 标头值,以此告知 API 它们将收到 JSON 格式的净负荷:
- Content-Type: application/json
- x-li-format: json
请求通过 POST 或 PUT 发送数据的每个 API 调用,其数据结构与净负荷所要求的结构不同。请参照与您特定调用相关的示例文档,了解完成请求所需的确切 XML 和 JSON 净负荷格式。
了解请求限制
为避免滥用和确保稳定性,所有 REST API 请求均会受到限制。根据发起请求的类型,应用每天可调用的确切次数会有所不同。您可在每个特定 API 调用文档旁找到此信息。
目前采取三种不同的限制方式:
- 应用限制 - 应用每天可调用的总次数。
- 用户限制 - 单个个体成员每天可使用应用调用的总次数。
- 开发人员限制 - 在应用设置中被确定为“开发人员”的用户每天可调用的总次数。
处理分页响应
如要翻页浏览结果,请将起始值设为 0,将计数值设为 N。如要获取下一页,请将起始值设为 N,计数值保持不变。 后续页将以 2N、3N、4N……开头
如果结果集中的起始值 + 计数值 >= “_合计”值,您将分页浏览所有结果。
例如: