Skip to main content
GET
按邮政编码查询城市和州/省

授权

Authorization
string
header
必填

会话 JWT(来自注册/登录)或 API key(pk_...)。 也接受 X-API-Key: <token> 作为替代请求头。

查询参数

country
string
必填

ISO 3166-1 alpha-2 国家/地区代码。目前仅 US 有数据集。

Pattern: ^[A-Z]{2}$
code
string
必填

要解析的邮政编码(5 位美国 ZIP)。

Pattern: ^[0-9]{5}$

响应

该邮政编码对应的城市和州/省。

country
string

原样返回的 ISO 3166-1 alpha-2 国家/地区代码。

postal_code
string
city
string
state
string

ISO 3166-2 行政区划代码后缀(如 FL)。

最后修改于 2026年8月22日