コンテンツへスキップ
Minare
ja
Minare

開発者

APIとMCPによる礼拝時刻

Minareアプリの計算エンジン：世界中どこでも使える礼拝時刻、月間時刻表、キブラ、ヒジュラ暦の日付。トルコではディヤーナトが標準の方法です。

このウェブサイトのすべてのページは公開されており無料です。APIとMCPサーバーは、時刻を自分のアプリやアシスタントに取り込むためのもので、キーが必要です。

プラン

Trial

お試しや小規模なプロジェクト向け。カードは不要です。

無料

  • 1分あたり 10 リクエスト
  • 1か月あたり 1,000 リクエスト
  • JSON APIのすべて
  • MCPサーバー
  • すべての計算方法
キーを取得

Pro

アプリ、ウェブサイト、ボット向け。

$9/月

  • 1分あたり 60 リクエスト
  • 1か月あたり 100,000 リクエスト
  • JSON APIのすべて
  • MCPサーバー
  • すべての計算方法
キーを取得

Business

大量のトラフィックと組織向け。

$49/月

  • 1分あたり 300 リクエスト
  • 1か月あたり 1,000,000 リクエスト
  • JSON APIのすべて
  • MCPサーバー
  • すべての計算方法
キーを取得

制限はアカウントのプランに紐づきます。APIとMCPのリクエストは同じ上限に計上されます。有料プランはPolarを通じて月払いで、ダッシュボードからいつでも解約できます。

キーの取得

  1. 1Apple、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

    1日分：イムサーク、ファジュル、日の出、ズフル、アスル、マグリブ、イシャー、追加の時刻

  • 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。省略した場合は国ごとに選択されます

制限

すべてのレスポンスには、1分あたりの制限を示すRateLimit-Limit、RateLimit-Remaining、RateLimit-Reset、月間の上限を示すX-Quota-Limit、X-Quota-Remaining、X-Quota-Resetが含まれます。上限を超えると、Retry-After付きの429が返されます。

ドキュメント