Ir para o texto

Desenvolvedores

Construa com o Ember

O diretório de horários de Missa do Ember é aberto: igrejas do mundo todo com os horários de suas Missas, confissões e adoração. Não há chaves nem cadastro, e toda resposta aceita qualquer origem.

Passe isto ao seu agente ember.dpgu.me/llms.txt · esta página em Markdown

Primeiros passos

A API responde a um simples GET. No terminal:

Terminal
# As cinco igrejas mais próximas da Sé de São Paulo
curl 'https://ember-mass-times.dpgu.workers.dev/churches/near?lat=-23.5505&lng=-46.6333&limit=5'

Bom uso

  • Guarde o que buscar. Os dados das igrejas mudam de um dia para o outro: pode guardá-los por até um dia, e um espelho pode se atualizar diariamente. Busque de novo uma igreja quando alguém a abrir, para que veja as últimas correções. As leituras não têm limite de frequência; com muito tráfego, sirva uma cópia sua em vez de chamar a API a cada visitante.
  • Mostre quando o horário foi conferido. As paróquias mudam seus horários e um diretório fica para trás. Mostre lastVerifiedAt ao lado dos horários, e deixe as pessoas confirmá-los ou enviar uma correção pelo seu aplicativo.
  • Cite o Ember, se puder. Ficaremos gratos por uma linha como “Horários do Ember” com link para ember.dpgu.me/pt/app/. Onde mostrar uma só igreja, a página dela no Ember, https://ember.dpgu.me/pt/horarios-de-missa/igreja/?id={id}, também é um bom link.
  • Escritas são sugestões. Uma correção vai para uma fila que uma pessoa revisa e nunca altera uma igreja diretamente. Uma confirmação conta uma vez por cliente e igreja a cada 30 dias. Cada cliente pode escrever 20 vezes por minuto; acima disso a API responde 429.
  • Identifique cada aparelho ou pessoa. Um cliente é o seu endereço IP junto com o cabeçalho X-Client-Id. Envie um id fixo por aparelho ou usuário, para que pessoas que compartilham um endereço, como todos cujas escritas passam pelo seu servidor, tenham limites e confirmações separados.

Código-fonte