Es una API que permite obtener la letra y la música (instrumental y cantado) de las canciones del Himnario Adventista Edición 2009.
La API se encuentra en la siguiente dirección: https://sdah.my.to/hymn.
⚠️ Esta API está en constante desarrollo y puede cambiar en cualquier momento.
La música está hosteada en Google Drive y está disponible para su descarga.
| Método | Endpoint | Descripción |
|---|---|---|
 |
/hymn | Devuelve un Array con todas las canciones. |
Estos parámetros pueden usarse en /hymn para modificar la respuesta:
-
pageylimit: se deben usar juntos para activar la paginación.page: número de la página.limit: cantidad de himnos por página.
Ejemplo:
/hymn?page=1&limit=5devuelve los primeros 5 himnos. -
search: búsqueda por número o título del himno.Ejemplo:
/hymn?search=señordevuelve todos los himnos que contengan “señor” en el título. -
fields: selecciona qué campos incluir en la respuesta. Valores posibles:verses: incluye las estrofas y su contenido.
Ejemplo:
/hymn?fields=versesdevuelve los himnos con sus estrofas.
| Código | Response |
|---|---|
 |
Hymn[] |
| Método | Endpoint | Descripción |
|---|---|---|
|
/hymn/:number | Devuelve el contenido de la canción y la secuencia de estrofas. |
| Código | Response |
|---|---|
|
HymnSequence |
 |
Hymn not found |
interface Hymn = {
id: number // ID de la canción
number: number // número de la canción
title: string // título de la canción
mp3Url: string // URL del archivo mp3
mp3UrlInstr: string // URL del archivo mp3 con la pista instrumental
mp3Filename: string // nombre del archivo mp3
bibleReference: string // referencia bíblica asociada al himno
}interface HymnSequence = {
id: number // ID de la canción
number: number // número de la canción
title: string // título de la canción
mp3Url: string // URL del archivo mp3
mp3UrlInstr: string // URL del archivo mp3 con la pista instrumental
mp3Filename: string // nombre del archivo mp3
bibleReference: string // referencia bíblica asociada al himno
verses: {
id: number // ID de la estrofa
number: number // número de la estrofa (0 si es el coro)
contents: {
id: number // ID del contenido
content: string // contenido de la estrofa
}[]
}[]
sequence: {
id: number // ID de la secuencia
timestamp: number // marca de tiempo en milisegundos del mp3
verseId: number // ID de la estrofa
verseContentId: number // ID del contenido de la estrofa
}[]
}
https://github.com/jh0rman/himnario-adventista-api
Leave a Reply