본문으로 건너뛰기
Minare
ko
Minare

개발자

API와 MCP로 제공하는 예배 시간

Minare 앱의 계산 엔진: 지구상 어디서나 예배 시간, 월간 시간표, 키블라, 히즈라력 날짜. 튀르키예에서는 디야네트가 기본 방식입니다.

이 웹사이트의 모든 페이지는 공개되어 있으며 무료입니다. 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. 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

    하루: 이므삭, 파즈르, 일출, 두흐르, 아스르, 마그립, 이샤, 추가 시간

  • 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가 포함됩니다. 한도를 넘으면 Retry-After와 함께 429가 반환됩니다.

문서