地理与旅行

邮编查询 API

将 21 国邮编解析为地名与坐标。

请求标头

Name	Required	Description
`X-RapidAPI-Key`	required	Your RapidAPI key. Get one free.
`X-RapidAPI-Host`	required	`postal-codes.p.rapidapi.com`

端点

GET /v1/postalcodes

Resolve a postal code to places and coordinates

参数

Name	Type	Required	Default	Constraints
`code`	string	required	—	matches \S
`country`	string	optional	—	—
`limit`	integer	optional	—	—
`offset`	integer	optional	—	—

代码示例

curl --request GET \
  --url 'https://postal-codes.p.rapidapi.com/v1/postalcodes?code=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: postal-codes.p.rapidapi.com'

const url = "https://postal-codes.p.rapidapi.com/v1/postalcodes?code=example";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "postal-codes.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://postal-codes.p.rapidapi.com/v1/postalcodes"

querystring = {"code": "example"}

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "postal-codes.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

GET /v1/postalcodes/countries

List all countries that have postal codes in the dataset, sorted alphabetically by ISO code.

代码示例

curl --request GET \
  --url 'https://postal-codes.p.rapidapi.com/v1/postalcodes/countries' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: postal-codes.p.rapidapi.com'

const url = "https://postal-codes.p.rapidapi.com/v1/postalcodes/countries";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "postal-codes.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://postal-codes.p.rapidapi.com/v1/postalcodes/countries"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "postal-codes.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

交互示例

postal-codes

$ GET /v1/postalcodes?code=90210&country=US
{"data":[{"country":"US","code":"90210","place":"Beverly Hills","admin1":"California","latitude":34.0901,"longitude":-118.4065}],"meta":{"total":1,"limit":10,"offset":0}}

订阅和许可

通过 RapidAPI 上的商业就绪层访问此 API。专为副项目、初创公司和大批量生产架构设计的灵活计划。

查看定价并订阅

开发者支持

需要集成帮助或有自定义端点请求？我们的工程团队随时为身份验证、有效负载模式和高频速率限制增加提供协助。

联系 API 工程部

系统性能

全天候 24/7 监控，正常运行时间 SLA 达 99.9%。构建在具有全球分布式边缘缓存的云原生微服务之上，以确保超低延迟响应时间。

所有系统均可运行