La API de Sakura Tarot permite a los usuarios acceder a un conjunto de cartas de tarot, realizar lecturas y obtener significados de las cartas. Esta documentación te guiará sobre cómo utilizar la API y cómo se ha integrado en la aplicación.
URL: /api/cards
Método: GET
Descripción: Este endpoint devuelve una lista de todas las cartas de tarot disponibles.
Código de estado: 200 OK
[
{
"id": 1,
"name": "El Mago",
"image": "assets/cards/mago.png",
"meaning": "Representa la habilidad y la destreza."
},
{
"id": 2,
"name": "La Sacerdotisa",
"image": "assets/cards/sacerdotisa.png",
"meaning": "Simboliza la intuición y el conocimiento."
}
// ... más cartas
]
URL: /api/cards/random
Método: GET
Descripción: Este endpoint devuelve un número específico de cartas seleccionadas aleatoriamente.
count: (opcional) Número de cartas a devolver. Por defecto, se devuelve 3 cartas.
Código de estado: 200 OK
[
{
"id": 3,
"name": "La Emperatriz",
"image": "assets/cards/emperatriz.png",
"meaning": "Representa la fertilidad y la abundancia."
}
// ... más cartas
]
async function loadCards() {
try {
const cards = await getAllCards(); // Llama a la API para obtener todas las cartas
appState.allCards = shuffleArray(cards); // Almacena las cartas en el estado de la aplicación
console.log(`Cargadas ${cards.length} cartas de Sakura`);
} catch (error) {
console.error('Error al cargar cartas:', error);
appState.allCards = createDummyCards(); // Usa cartas de respaldo si hay un error
}
}
async function getRandomCards(count = 3) {
try {
const response = await fetch(`/api/cards/random?count=${count}`);
if (!response.ok) {
throw new Error('Error al obtener cartas aleatorias');
}
return await response.json(); // Retorna las cartas aleatorias
} catch (error) {
console.error('Error en la solicitud:', error);
return []; // Retorna un array vacío en caso de error
}
}
Es importante manejar los errores al consumir la API. Se utilizan bloques try-catch para capturar errores y mostrar mensajes apropiados al usuario.
La API de Sakura Tarot proporciona una forma sencilla de interactuar con un conjunto de cartas de tarot. Puedes utilizar los endpoints para obtener cartas y realizar lecturas, lo que enriquece la experiencia del usuario en la aplicación.