跳至主要内容

華人教會名錄 API

📋 申請流程​

在開始使用 API 之前，請先申請 API KEY。請將以下資訊寄送至 info@ccnda.org：

  1. 使用目的
  2. 使用者相關聯絡資訊

我們會在收到申請後，盡快為您處理並提供所需的 api_key。

🔐 API 存取說明​

  • API 採用 HTTPS 加密傳輸
  • 所有請求都需要在 URL 中包含您的 api_key
  • 基礎 URL：https://church.oursweb.net/api/

📚 API 端點說明​

取得單筆教會資訊​

GET https://church.oursweb.net/api/{api_key}/oid/{教會編號}

回傳資料欄位​

欄位說明
oid編碼
ocname中文名稱
ocnick中文別名
oename英文名稱
oenick英文別名
president職稱
cname代表人
tel電話
fax傳真
email1電子郵件
code國碼
country國名
city城市
town鄉鎮
zipcode郵碼
address地址1
address2地址2
lat緯度
lng經度
udate更新日期
orgpid宗派編碼
porg_cname宗派名稱

聚會時間資料結構​

{
    "meet": {
        "0": {
            "mname": "聚會名稱",
            "mweek": "週幾",
            "mbhour": "開始時",
            "mbminute": "開始分",
            "mehour": "結束時",
            "meminute": "結束分"
        }
    }
}

搜尋範圍內教會機構​

GET https://church.oursweb.net/api/{api_key}/latlng/{lat},{lng},{distance}
參數說明
lat緯度
lng經度
distance搜尋半徑（公尺）

關鍵字搜尋​

GET https://church.oursweb.net/api/{api_key}/search/{keyword}

取得教會圖片​

GET https://church.oursweb.net/api/img/{oid}

取得所有資料​

GET https://church.oursweb.net/data/church.json

資料欄位說明​

欄位說明
og類別
oc中文名稱
oe英文名稱
mt職稱
mn代表人
em電子郵件
t電話
f傳真
cc國別簡稱
co國別中文
z郵遞區號
cy城市
tn城市
a1地址1
a2地址2
lt緯度
lg經度
ul網址
ud修改日期
pd宗派編碼

🔄 資料更新與回報​

回報錯誤資訊​

POST https://church.oursweb.net/api/{api_key}/report/{oid}

請求參數​

參數說明
email回報者 Email
report回報內容

登錄新資料​

POST https://church.oursweb.net/api/{api_key}/add_data

請求參數​

參數說明
ocname教會名稱
passwd管理密碼
code國家（兩個字元，例：TW）
tel電話
email1Email
zipcode郵遞區號
city城市
area區域
address地址

📞 技術支援​

如有任何技術問題或需要協助，請聯絡我們：