常见问题
开发者最常问的问题的答案。
对开发者最常问问题的简短回答。详情见链接的页面。
数据
数据来自哪里？
来自官方登记册和公告：Handelsregister（商业登记册）、含年度财务报表的 Unternehmensregister（企业登记册）以及破产公告。新闻和网站内容来自网络。详见数据可用性。
我们自动从已公布的文件和公告中读取许多细节。我们为此采用最新技术，并在质量上投入大量精力；个别错误仍可能出现。
数据有多新？
公司档案来自我们的数据库。使用实时模式时，API 还会实时查询 Handelsregister，并返回当前登记的人员。文件在你请求时由 API 从登记册获取。
如果同一份文件不久前刚被获取过，它可能最多是 24 小时前的。
公司必须在资产负债表日后十二个月内公布年度财务报表，许多公司会用满这段时间。因此最新的报表往往是前年的。
为什么某家公司缺少某个值？
通常是因为公司无须公布它。公开什么取决于法律形式和规模：例如小型 GmbH 不公布损益表，因此通常没有它的营业收入。空值在响应中显示为 null 或 []。
如果多家公司同名会怎样？
对于多家公司共用的名称，API 可能返回其中一家，不一定是你想要的那家，或返回 404。如果需要精确，请用登记法院和登记号查询，例如“Ansbach HRB 6089”，或使用 entity_id。仅凭登记号不够，因为许多法院都有相同的号码。
计费
功能不返回数据时会消耗积分吗？
不会。功能仅在返回数据时计费。而 AI 模式即使没有找到公司也会计费。只有当 API 以 408 取消请求时才不计费。实时模式在每次成功的实时获取时都会消耗积分，即使没有显示任何新内容。
失败的请求要花多少？
不花钱。以错误结束的请求不计费；唯一的例外是 AI 模式的附加费。状态为 402 时，meta.request_credit_cost 给出该请求最多会花费多少。详见错误。
我需要积分订阅吗？
不需要。任何账户都可以使用公司档案、搜索与导出、文件和 Signals；你只需支付积分。积分订阅可解锁更多数据：
- Plus：人物档案。
- Pro：扩展财务 KPI、公司关系网络功能、按所有权、管理层和破产筛选的搜索条件，以及 Signals 主题“破产”。
- Max：Pro 的全部内容，另加深度股东信息功能、能源供应企业的业务报表，以及 Signals 主题“改制与并购”。
关于价格和套餐的一切，见计费。
初始积分和充值积分的有效期有多长？
新账户可获得 150 初始积分。没有积分订阅时，初始积分和充值积分的有效期为 30 天。只要积分订阅有效，它们就不会过期。
技术
我应该设置多长的超时？
对于实时模式、人物档案和文件，至少 120 秒，因为这些请求耗时较长。如果使用实时模式时只有实时获取失败，你会得到已存储的数据，不收取实时模式附加费。如果请求耗时过长，会以 408 结束，文件为 504。此时不收费。请稍后再试。
我可以发出多少请求？
公司档案每个账户每分钟 60 次请求，文件 5 次。超出后，API 返回状态 429，并在 Retry-After 中给出等待时间。所有限制见限制。
我可以重复请求而不重复付费吗？
可以，适用于公司档案、人物档案、搜索和文件。在请求头 Idempotency-Key 中发送你自己的值。如果你在 24 小时内用相同的键和相同的参数重复请求，则不收费。
我可以使用多个 API 密钥吗？
可以。在“账户 › API 密钥”下可以创建更多密钥，例如每个应用一个。删除的密钥会立即失效。所有密钥共用你账户的余额。