简介 - Cleariflow API

快速开始

验证 VAT 号码真实性，并获取包括国家、企业名称、地址和注册详情在内的全面公司信息。

根据各国特定法规、购买类型和交易金额计算符合 VAT 要求的定价，实现精确的财务计算。

获取特定国家的当前 VAT 税率和税类，确保符合当地税务法规。

VAT 验证 API 遵循 REST 原则，采用可预测的资源导向 URL 和标准 HTTP 状态码，实现无缝集成和错误处理。所有 API 端点必须以斜杠 (/) 结尾，且仅支持 GET 请求。

所有 API 通信均使用 TLS 1.2 或更高版本的加密协议进行保护，确保数据完整性和隐私。

VAT 验证 API 通过版本控制保持向后兼容，当前运行在第 1 版，并计划未来增强。

API 密钥是访问 VAT 验证 API 的唯一凭证。每个 Cleariflow 服务需要唯一的密钥，确保不同 API 之间的安全隔离访问。API 实施速率限制，确保所有用户的公平使用。

请求失败时，API 返回结构化的 JSON 错误响应，包含特定代码和描述，便于有效排查问题。

Code	Type	Details
200	OK	一切按预期运行。
400	Bad request	错误请求。
401	Unauthorized	请求不可接受。通常由于 API 密钥缺失或不正确。
422	Quota reached	由于 API 积分不足，请求被中止。（免费计划）
429	Too many requests	由于达到每秒允许请求数，请求被中止。免费计划的请求限制为每秒 1 次。
500	Internal server error	由于服务器端错误，无法完成请求。
503	Service unavailable	服务器不可用。

以下是 VAT 端点支持的国家列表