Ir para o conteúdo
Minare
pt
Minare

Desenvolvedores

Horários de oração, por API e MCP

O motor de cálculo dos apps Minare: horários de oração em qualquer lugar da Terra, tabelas mensais, a qibla e a data hégira. O Diyanet é o método padrão na Turquia.

Todas as páginas deste site são públicas e gratuitas. A API e o servidor MCP servem para levar os horários ao seu próprio app ou assistente, e exigem uma chave.

Planos

Trial

Para experimentar e para projetos pequenos. Sem cartão.

Grátis

  • 10 solicitações por minuto
  • 1.000 solicitações por mês
  • Toda a API JSON
  • O servidor MCP
  • Todos os métodos de cálculo
Obter uma chave

Pro

Para apps, sites e bots.

$9/mês

  • 60 solicitações por minuto
  • 100.000 solicitações por mês
  • Toda a API JSON
  • O servidor MCP
  • Todos os métodos de cálculo
Obter uma chave

Business

Para alto tráfego e organizações.

$49/mês

  • 300 solicitações por minuto
  • 1.000.000 solicitações por mês
  • Toda a API JSON
  • O servidor MCP
  • Todos os métodos de cálculo
Obter uma chave

Os limites pertencem ao plano da sua conta; as solicitações de API e MCP contam na mesma cota. Os planos pagos são cobrados mensalmente pela Polar e podem ser cancelados no painel a qualquer momento.

Como obter uma chave

  1. 1Entre com Apple, Google ou seu e-mail. Não há senha, e sua conta do Minare Qur'an também funciona aqui.
  2. 2Crie uma chave no painel de desenvolvedor. Ela é mostrada só uma vez; guardamos apenas um hash dela.
  3. 3Adicione a chave às suas solicitações. Você começa no plano Trial; faça upgrade pelo painel quando precisar de mais.
Obter uma chave

Autenticação

Envie sua chave em toda solicitação: Authorization: Bearer mk_… ou X-API-Key: mk_…. Solicitações sem uma chave válida recebem 401 e chaves revogadas recebem 403; o corpo aponta para esta página.

Exemplo

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

Endpoints

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

    Um dia: Imsak, Fajr, nascer do sol, Dhuhr, Asr, Maghrib, Isha e horários extras

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

    Tabela do mês

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

    A próxima oração e os segundos que faltam

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

    Direção da qibla e distância até a Caaba

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

    Buscar cidades e distritos

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

    Data hégira

Parâmetros comuns

city
Nome da cidade (Kadıköy, London) ou um caminho do minare.app (turkey/istanbul/kadikoy)
lat, lon, tz
Coordenadas no lugar de uma cidade; adicione tz para o fuso horário
date
YYYY-MM-DD; hoje no horário local se omitido
method
Método de cálculo; escolhido conforme o país se omitido
madhab
shafi ou hanafi; escolhido conforme o país se omitido

Limites

Toda resposta traz RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset para o limite por minuto, e X-Quota-Limit, X-Quota-Remaining e X-Quota-Reset para a cota mensal. Acima do limite você recebe um 429 com Retry-After.

Documentação