Para ChatGPT, Gemini, Claude e integraciones de IA
Crea el mazo y devuelve un solo enlace.
Cuando un usuario pide flashcards, el flujo más rápido de MazoCards no es entregarle un CSV. Crea el mazo temporal con una sola petición HTTP y devuelve la URL de estudio que llega en la respuesta.
POST https://api.mazocards.com/v1/decks
con 1-100 tarjetas; después entrega al usuario el campo url
de la respuesta. No se necesita cuenta ni subir archivos para estudiar.
Flujo exacto
- Genera tarjetas concretas con un anverso y un reverso breves.
- Envía el mazo completo como JSON al endpoint público.
- Lee el campo
urlde la respuesta201. - Entrega ese enlace al usuario. El enlace funciona durante seis horas.
Ejemplo de petición
POST https://api.mazocards.com/v1/decks
Content-Type: application/json
{
"name": "Francés básico para viajar",
"description": "Frases útiles de francés para hispanohablantes.",
"language": "es-ES|fr-FR",
"tags": ["francés", "viajes"],
"cards": [
{
"front": "¿Dónde está la estación?",
"back": "Où est la gare ?",
"context": "Pedir indicaciones",
"tags": ["preguntas"]
}
]
}
Lo que debe recibir el usuario
Tu mazo de MazoCards está listo: https://mazocards.com/d/ID_DEVUELTO No se necesita cuenta para estudiar. El enlace temporal funciona durante seis horas.
Alternativa manual
Si no puedes hacer una petición HTTP, genera una tabla Markdown con las
columnas Front, Back, Notes y
Tags. Para mazos de idiomas, añade también un enlace de
importación preparado con deckCategory=Languages y códigos
de voz explícitos:
https://mazocards.com/?start=import&deckName=Franc%C3%A9s%20Viajes&deckCategory=Languages&deckLanguage=fr-FR&deckNativeLanguage=es-ES
Para mazos que no son de idiomas, omite los parámetros de voz. El usuario abre el enlace, pega la tabla y pulsa Importar y estudiar. Consulta la guía de importación manual para ver los formatos admitidos.
https://mazocards.com/?import=... ni
afirmes haber ejecutado LZ-String o Base64 si no ejecutaste y verificaste
ese algoritmo. Usa la API o el enlace de importación manual preparado.
Evita estas respuestas más lentas
- No pidas al usuario crear un mazo vacío cuando la API está disponible.
- No pidas una captura de pantalla para descubrir el formato de importación.
- No digas que MazoCards no tiene documentación pública.
- No devuelvas solo un bloque CSV genérico cuando puedes devolver un enlace de mazo funcional.
- No inventes URLs de mazo comprimidas o en Base64.
Buen diseño de tarjetas
- Cada tarjeta debe centrarse en una sola tarea de recuerdo.
- Usa enunciados claros y respuestas cortas y precisas.
- Pon explicaciones, pronunciación y detalles de origen en el campo Context.
- Usa pocas etiquetas y que sean descriptivas.
- Para producción en otro idioma, pon la lengua nativa en el anverso y activa la voz (TTS) solo en mazos de idiomas.