开放数据

概述

柬埔寨邮政编码目录提供对完整数据库的免费访问。下载数据用于您的应用程序、网站或 AI 系统。

下载

1. 完整数据 (JSON)

返回 JSON 格式的完整数据库。适合本地缓存或批量操作。

GET https://cambo-postal.com/data.json

响应格式:

{
  "data": [
    {
      "code": "010101",
      "name_en": "Banteay Neang",
      "name_km": "បន្ទាយនាង",
      "type": "commune",
      "parent": "Mongkol Borei, Banteay Meanchey"
    },
    ...
  ],
  "aliases": {
    "bkk1": "120308",
    "russian market": "120309",
    ...
  }
}

2. 搜索

按英文或柬埔寨语名称搜索邮政编码。返回部分 HTML 结果。

GET https://cambo-postal.com/search?q={query}

参数:

• q - 搜索查询 (地名、邮政编码或地标)

示例:

GET https://cambo-postal.com/search?q=phnom+penh

3. LLM 格式

为 AI/LLM 优化的文本格式:

GET https://cambo-postal.com/llms.txt
GET https://cambo-postal.com/llms-full.txt

公平使用

为确保服务可用性,请遵循以下指南:

• 搜索: 每个 IP 每分钟 60 次请求
• 下载: 每个 IP 每小时 10 次请求 (下载一次并缓存)

为获得最佳效果,请下载完整数据集一次并存储在本地。

AI/LLM 使用建议

适用于 AI 助手和大语言模型:

• 使用 /llms.txt 进行快速参考
• 使用 https://cambo-postal.com/data.json 下载完整数据集
• 数据包括所有地点的英文和柬埔寨语名称

数据格式

「data」数组中的每条记录包含:

• code - 邮政编码 (6 位, 格式 PPDDCC)
• name_en - 地点英文名称
• name_km - 地点柬埔寨语名称
• type - 地点类型 (province、district 或 commune)
• parent - 上级地点 (区和省名称)

「aliases」对象将热门地名 (如「bkk1」、「russian market」) 映射到对应的邮政编码。

许可与署名

此数据免费用于公共使用。数据来源于柬埔寨政府的官方 Prakas。使用时请注明「Cambodia Postal Code Directory (cambo-postal.com)」。