帮助中心GitHub

校验地址

通过 USPS 标准化美国地址并检查可投递性。按调用计费。

通过 USPS 校验并标准化一个美国地址,不保存。 除标准化地址外,还返回可投递性情报:ZIP+4、投递路线(carrier route)、DPV 可投递确认,以及是否为住宅地址——住宅属性决定了大多数承运商是否加收住宅附加费。 **此端点按调用计费。** 实际扣费金额在响应的 `billed` 字段中返回。命中缓存与实时查询计费相同。使用**沙箱** API key 的请求免费,返回模拟结果。 `POST /v1/rates` 内部自动执行的地址校验**不计费**——只有直接调用本端点才计费。`POST /v1/addresses/verify` 是本端点的别名,计费方式完全相同。

参数

请求体

street1 string 必填
街道地址。
street2 string
公寓、套房或单元号。请务必传入——单元号是投递点的组成部分,漏传可能改变地址是否可投递的判定。
city string 必填
城市名。
state string 必填
2 位字母的州代码(例如 CA)。
zip string 必填
5 位 ZIP 或 ZIP+4。
country string
默认 US。目前仅支持美国地址。

返回

200 校验结果。billed 字段为本次扣费金额。
400 地址参数无效
401 需要身份验证
402 钱包余额不足——不返回校验结果
429 超出速率限制

相关

addresses
validation
usps
POST/api/v1/addresses/validate