开发者API钥匙

开发者是什么？API ？

LeyApp公开 RESTAPI在 /api/v1 下，您可以搜索律师、查看其空闲时间，并通过您自己的网站、应用程序或内部工具发起预约。基本读取权限无需任何凭据即可使用，但需要更多凭据才能访问。API密钥可以提高您的速率限制，解锁额外的端点，并为您提供一个包含密钥和使用情况的仪表板。

任何LeyApp账户可以创建API钥匙——您不需要特殊的账户类型。预订通过以下方式开始：API绝不会自动扣款：客户始终需要确认并付款。leyapp.es因此，您的集成永远不会处理资金或银行卡详细信息。

创建一个API钥匙

密钥通过您的控制面板进行管理：

1. 从侧边栏打开控制面板 → 开发者。
2. 点击“创建密钥”，并为其指定一个描述性名称，例如“网站小部件（正式版）”。
3. 选择密钥类型：用于真实请求的“实时”密钥，或用于安全试验的“测试”密钥。
4. 立即复制密钥并将其存储在安全的地方，例如密码管理器或主机提供商的秘密存储空间。

测试密钥与正式密钥

测试密钥（leyk_test_...）的行为与正式密钥完全相同——相同的端点、相同的响应、相同的验证——只有一个关键区别：测试密钥不会执行任何实际操作。测试预订请求会根据实际可用性进行全面检查，但不会创建预订意图，也不会通知任何律师。

实时密钥（leyk_...）用于创建真实的预订意图。当客户点击实时意图的确认链接时，他们将被引导至正常的预订页面。LeyApp支付和确认流程。

公司钥匙

如果您隶属于一家律师事务所，LeyApp在“控制面板”→“开发者”中，会显示两个独立的列表：您的个人密钥和您所在公司的密钥。公司密钥属于公司所有，而非创建者个人所有，因此即使创建者更换职位或离职，密钥仍然有效。

所有者和管理员可以立即管理公司密钥。其他所有成员最初都没有访问权限，必须从公司成员列表中逐一授予权限：

• 查看——可以看到公司的密钥、密钥前缀以及每把密钥的最后使用时间。密钥本身永远不会再向任何人透露，包括密钥所有者。
• 管理——创建、撤销、暂停和限制公司的密钥。
• Webhooks — 管理公司的 webhook 端点。

密钥还有两项额外的控制功能。您可以将密钥限制在特定的 IP 地址列表或地址范围内，这样即使是泄露的密钥也无法从其他任何地方使用。此外，您还可以暂停密钥，使其暂时失效而不会被销毁，这在调查异常情况时非常有用。

使用您的钥匙

在每个请求的 Authorization 标头中发送密钥：“Authorization: Bearer leyk_...”。没有密钥的请求仍然可以访问公共端点，但匿名速率限制会降低。

每个响应都包含一个 X-Request-Id 标头。如果出现异常情况，请在联系支持人员时提供该 ID——这能让我们在几秒钟内找到您的确切请求。

速率限制

新密钥从免费套餐开始：每分钟 60 次请求，每天 5,000 次请求。每次响应都会通过 X-RateLimit-Limit 和 X-RateLimit-Remaining 标头告知您当前请求量；如果超出限制，您将收到一个 429 响应，其中包含一个 Retry-After 标头，告知您何时重试。

合作伙伴级别更高，由……授予。LeyApp团队——如果您的集成需要更多空间，请通过支持表单联系我们。

妥善保管钥匙

一个APIkey 是您集成的密码。请像对待密码一样对待它：

• 永远不要将密钥放在客户端代码、移动应用程序或公共存储库中——任何能够读取它的人都可以耗尽您的速率限制并在密钥的作用域内执行操作。
• 每个集成或环境使用单独的密钥，这样就可以撤销一个密钥而不会影响其他密钥。
• 撤销您不再使用的密钥。撤销操作立即生效——使用已撤销密钥的请求将在下次调用时失败。
• 如果密钥可能已泄露，请立即在“控制面板”→“开发者”中撤销该密钥并创建替代密钥。密钥轮换过程零停机：先创建新密钥并部署，然后撤销旧密钥。

故障排除

我收到 401“无效”错误。API钥匙”。

请检查请求头是否完全为“Authorization: Bearer leyk_...”，不包含任何空格，并确认密钥未被撤销。请注意，MCP 令牌（ley_...）位于“设置”→API令牌是另一种凭证，在 REST 中无效。API 。

我收到错误代码 429“超出速率限制”。

您已达到套餐的每分钟或每日流量上限。请遵循“重试时间”标头，并使用指数退避算法重试。如果您经常达到每日流量上限，请咨询我们了解更高套餐的相关信息。

我的考试预约信息从未显示出来。

这是有意为之——测试密钥会验证所有功能，但不会创建任何实际内容。切换到正式密钥即可创建真实的预订意图。

我无法解除对公司某把钥匙的冻结。

贵公司或任何其他机构都可以暂停使用某把钥匙。LeyApp贵公司自身作出的停牌决定可由任何所有者或管理者解除。LeyApp例如，在我们调查异常流量期间，只有我们才能解除限制，因此请联系 support@leyapp.es 。