跳到內容
Minare
zh-hant
Minare

開發者

禮拜時間，透過 API 和 MCP

Minare 應用程式的計算引擎：地球上任何地方的禮拜時間、月度時間表、禮拜朝向和伊斯蘭曆日期。在土耳其，預設方法為宗教事務局（Diyanet）。

本網站的每個頁面都是公開且免費的。API 和 MCP 伺服器用於把禮拜時間接入您自己的應用程式或助理，需要金鑰。

方案

Trial

適合試用和小型專案。不需要信用卡。

免費

  • 每分鐘 10 次請求
  • 每月 1,000 次請求
  • 完整的 JSON API
  • MCP 伺服器
  • 所有計算方法
取得金鑰

Pro

適用於應用程式、網站和機器人。

$9/月

  • 每分鐘 60 次請求
  • 每月 100,000 次請求
  • 完整的 JSON API
  • MCP 伺服器
  • 所有計算方法
取得金鑰

Business

適用於高流量和機構。

$49/月

  • 每分鐘 300 次請求
  • 每月 1,000,000 次請求
  • 完整的 JSON API
  • MCP 伺服器
  • 所有計算方法
取得金鑰

限制取決於您帳號的方案；API 和 MCP 請求計入同一額度。付費方案透過 Polar 按月計費，可隨時在控制台取消。

取得金鑰

  1. 1用 Apple、Google 或您的電子郵件登入。沒有密碼，您的 Minare Kur'an 帳號在這裡同樣可用。
  2. 2在開發者控制台建立金鑰。它只顯示一次；我們只保存其雜湊。
  3. 3請在請求中帶上金鑰。您從試用方案開始；需要更多額度時可在控制台升級。
取得金鑰

驗證

每個請求都帶上您的金鑰：Authorization: Bearer mk_… 或 X-API-Key: mk_…。沒有有效金鑰的請求回傳 401，已撤銷的金鑰回傳 403；回應內文包含指向此頁面的連結。

範例

curl https://minare.app/api/v1/times?city=istanbul \
  -H "Authorization: Bearer mk_…"

端點

  • GET /api/v1/times?city=Kadıköy

    一天：伊姆薩克、晨禮、日出、晌禮、晡禮、昏禮、宵禮和附加時間

  • GET /api/v1/month?city=london&year=2027&month=2

    月度時間表

  • GET /api/v1/next?lat=41.01&lon=28.98

    下一次禮拜和剩餘秒數

  • GET /api/v1/qibla?city=berlin

    禮拜朝向方位和到天房的距離

  • GET /api/v1/cities?q=ist

    搜尋城市和區

  • GET /api/v1/hijri?date=2027-02-08

    伊斯蘭曆日期

通用參數

city
城市名稱（Kadıköy、London）或 minare.app 路徑（turkey/istanbul/kadikoy）
lat, lon, tz
以座標代替城市；時區請加上 tz
date
YYYY-MM-DD；省略時為當地今天
method
計算方法；省略時依國家選擇
madhab
shafi 或 hanafi；省略時依國家選擇

限制

每個回應都帶有 RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset（每分鐘限制），以及 X-Quota-Limit、X-Quota-Remaining 和 X-Quota-Reset（每月額度）。超出限制時回傳 429 和 Retry-After。

文件