US ZipCode

简介

Smarty 的 US ZIP Code API 返回邮编级数据——城市、州和坐标。认证是 Smarty auth-id + token（缺失/无效 → 401，已实测）。

快速开始

查询（替换你的凭据）：

curl "https://us-zipcode.api.smartystreets.com/lookup?auth-id=YOUR_ID&auth-token=YOUR_TOKEN&zipcode=90210"

[
  {
    "zipcode": "90210",
    "zipcode_type": "S",
    "default_city": "Beverly Hills",
    "county_fips": "06037",
    "state": "CA",
    "latitude": 34.09,
    "longitude": -118.41
  }
]

认证方式

• 在 smarty.com 注册 → US ZIP Code API → auth-id + auth-token。
• 作为 auth-id 和 auth-token 查询参数发送（缺失 → 401，已实测）。

速率限制与注意事项

• 免费层：250 次查询/月（看控制台）；付费档可扩展。
• 按 zipcode 或 city/state 查询；返回县 FIPS 和坐标。

常见问题

Smarty US ZIP Code 免费吗？ 免费层：250 次/月；更多需要付费。

如何获取凭据？ smartystreets.com → 创建账号 → auth-id/token。

为什么 401？ 需要 auth-id/auth-token（已实测）。