Antes de la primera llamada
Estêvão expone el calendario litúrgico, lecturas, colectas, libros de oración y versiones bíblicas. Esta referencia explica cómo elegir la fuente de los datos y cómo verificar lo que volvió.
¿Empiezas ahora? Empieza por la v2.
Respuestas livianas por defecto, include y fields para pedir solo lo que necesitas, rangos de fechas en una llamada y errores en problem+json. El sandbox del playground ya habla v2.
01 / Alcance
Qué organiza la API
Los datos nunca llegan aislados. Un día puede apuntar a su tiempo litúrgico, celebraciones, colectas y lecturas; una lectura puede registrar el libro de oración y la variante de leccionario usados para seleccionarla.
Estructura explícita
Preferencias, códigos y metadatos permanecen visibles en la respuesta.
Decisiones verificables
La explicación litúrgica registra el origen de las lecturas y la variante seleccionada.
02 / URL base
Todas las rutas parten de aquí
Usa HTTPS y envía la clave en el encabezado X-API-Key, como se describe en la página siguiente. Hay dos versiones publicadas lado a lado.
https://api.caminhoanglicano.com.br/api/v2https://api.caminhoanglicano.com.br/api/v1La v2 es la superficie recomendada para integraciones nuevas. La v1 sigue en línea, sin fecha de retiro: la app Ordo usa la v1 y quien ya integró no necesita migrar.
03 / Secuencia sugerida
Un camino corto hasta el primer JSON
- 01
Entra al portal
Con Google o correo. En el primer acceso el backend crea tu perfil de desarrollador.
- 02
Elige un plan
El plan define el límite de solicitudes de tus claves. Los primeros siete días son de prueba.
- 03
Crea una clave reconocible
Ponle a la clave el nombre del proyecto o del entorno. El valor completo aparece una sola vez.
- 04
Consulta el catálogo
Mira qué libros de oración están disponibles y qué preferencias acepta cada edición.
- 05
Haz una llamada en el playground
Elige un endpoint, revisa los parámetros y lee la respuesta antes de llevar la consulta al código.
- 06
Conecta tu aplicación
Envía la clave en la cabecera y mantenla fuera del código público y del frontend.