ZipTax 销售税查询

设置

将 ZIPTAX_API_KEY 环境变量设置为从 https://platform.zip.tax（开发 > API 密钥）获取的 API 密钥。

免费套餐每月提供 100 次调用。切勿公开分享您的 API 密钥。

快速开始

地址查询（最准确）

curl -s "https://api.zip-tax.com/request/v60?address=200+Spectrum+Center+Drive+Irvine+CA+92618" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

邮政编码查询

curl -s "https://api.zip-tax.com/request/v60?postalcode=92618" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

经纬度查询

curl -s "https://api.zip-tax.com/request/v60?lat=33.6525&lng=-117.7479" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

工作流程

1. 确定查询类型：地址（最佳）、经纬度或邮政编码
2. 使用 v60（最新版本）以获取完整的管辖区域细分；如需简单合并税率，可使用 v10
3. 向 https://api.zip-tax.com/request/v60 发送 GET 请求，并附带认证头
4. 检查 metadata.response.code — 值为 100 表示成功
5. 读取 taxSummaries[0].rate 获取总销售税率
6. 读取 baseRates 数组以获取州、县、市、区等税率细分
7. 检查 service.taxable 和 shipping.taxable 判断服务费和运费是否应征税

重要说明

• 地址 > 邮政编码：地址查询返回唯一精确结果；邮政编码查询返回该 ZIP 码下所有税率
• 认证方式：使用请求头 X-API-KEY 或查询参数 key
• 税率格式：小数形式（例如 0.0775 = 7.75%）
• 响应码 100 = 成功；请检查 metadata.response.code
• 指标接口（/account/metrics）不计入配额限制

内置资源

• **scripts/lookup.sh** — CLI 快速查询封装脚本。可通过 --address、--lat/--lng、--postalcode 或 --metrics 参数运行
• **references/api-reference.md** — 完整 API 参考文档，包含所有端点、响应结构、代码示例、响应码及 SDK 链接。在需要了解端点详情或响应字段定义时查阅