ទិន្នន័យបើកចំហ

ទិដ្ឋភាពទូទៅ

បញ្ជីកូដប្រៃសណីយ៍កម្ពុជាផ្តល់ការចូលប្រើ API ដោយឥតគិតថ្លៃទៅកាន់មូលដ្ឋានទិន្នន័យកូដប្រៃសណីយ៍ពេញលេញរបស់យើង។ ទិន្នន័យនេះអាចប្រើដោយអ្នកអភិវឌ្ឍន៍ ជំនួយការ AI និងប្រព័ន្ធស្វ័យប្រវត្តិ។

Endpoints API

1. ទិន្នន័យពេញលេញ (JSON)

ត្រឡប់មូលដ្ឋានទិន្នន័យកូដប្រៃសណីយ៍ពេញលេញជា JSON array។ ល្អបំផុតសម្រាប់ការ cache ក្នុងតំបន់ ឬប្រតិបត្តិការជាច្រើន។

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. API ស្វែងរក

ស្វែងរកកូដប្រៃសណីយ៍តាមឈ្មោះជាភាសាអង់គ្លេស ឬខ្មែរ។ ត្រឡប់លទ្ធផល HTML partial។

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

Parameters:

• 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

កំណត់អត្រា

ដើម្បីធានាការប្រើប្រាស់សមរម្យ និងភាពអាចរកបានសេវាកម្ម កំណត់អត្រាខាងក្រោមត្រូវអនុវត្ត:

• API ស្វែងរក: ៦០ សំណើក្នុងមួយនាទីក្នុងមួយ IP
• API ទិន្នន័យពេញលេញ: ១០ សំណើក្នុងមួយម៉ោងក្នុងមួយ IP (ទិន្នន័យត្រូវបាន cache ទាញយកម្តង)

សម្រាប់ការប្រើប្រាស់បរិមាណខ្ពស់ សូមទាញយកសំណុំទិន្នន័យពេញលេញម្តង ហើយ cache ក្នុងតំបន់។

គន្លឹះការប្រើប្រាស់ AI/LLM

សម្រាប់ជំនួយការ AI និង language models:

• ប្រើ /llms.txt សម្រាប់ឯកសារយោង និងទិដ្ឋភាពទូទៅរហ័ស
• ប្រើ https://cambo-postal.com/data.json ដើម្បីទាញយកសំណុំទិន្នន័យពេញលេញសម្រាប់សំណួរទូលំទូលាយ
• ទិន្នន័យរួមបញ្ចូលទាំងឈ្មោះអង់គ្លេស និងខ្មែរសម្រាប់ទីតាំងទាំងអស់

ទម្រង់ទិន្នន័យ

កំណត់ត្រាកូដប្រៃសណីយ៍នីមួយៗក្នុង 'data' array រួមបញ្ចូល:

• code - កូដប្រៃសណីយ៍ (៦ ខ្ទង់ ទម្រង់ PPDDCC)
• name_en - ឈ្មោះទីតាំងជាភាសាអង់គ្លេស
• name_km - ឈ្មោះទីតាំងជាភាសាខ្មែរ
• type - ប្រភេទទីតាំង (ខេត្ត ស្រុក ឬឃុំ)
• parent - ទីតាំងមេ (ឈ្មោះស្រុក និងខេត្ត)

Object 'aliases' ភ្ជាប់ឈ្មោះទីកន្លែងល្បី (ឧ. 'bkk1', 'russian market') ទៅកូដប្រៃសណីយ៍ដែលត្រូវគ្នាសម្រាប់ការស្វែងរកងាយស្រួល។

អាជ្ញាប័ណ្ណ និងការដកស្រង់

ទិន្នន័យនេះផ្តល់ដោយឥតគិតថ្លៃសម្រាប់ការប្រើប្រាស់សាធារណៈ។ ទិន្នន័យមកពីប្រកាសផ្លូវការរបស់រាជរដ្ឋាភិបាលកម្ពុជា។ សូមដកស្រង់ 'Cambodia Postal Code Directory (cambo-postal.com)' នៅពេលប្រើទិន្នន័យនេះ។