跳到内容
Minare
zh-hans
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。

文档