校验地址
通过 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