GIFs de anime para tu bot

Empezar

1. Únete a nuestro servidor de Discord.
2. Usa /apikey crear. La key se muestra una sola vez, así que guárdala.
3. Envíala en la cabecera Authorization de cada petición:

curl -H "Authorization: Bearer TU_KEY" /v1/gifs/hug

Endpoints

Todos usan GET, responden en JSON y necesitan una API key.

Respuesta de un GIF

{
  "categoria": "hug",
  "url": "/gifs/hug/archivo.gif",
  "anime": "Nombre del anime",
  "contribuidor": "Nombre de quien lo aportó"
}

anime y contribuidor pueden ser null.

Respuesta de una pregunta de trivia

{
  "categoria": "anime",
  "pregunta": "¿Quién creó One Piece?",
  "opciones": ["Akira Toriyama", "Eiichiro Oda", "Masashi Kishimoto", "Tite Kubo"],
  "respuesta": "Eiichiro Oda"
}

Categorías de GIFs

Toca una para ver un ejemplo.

Ejemplos

const res = await fetch('/v1/gifs/hug', {
  headers: { Authorization: `Bearer ${process.env.MIKAN_API_KEY}` },
});
if (!res.ok) throw new Error(`Mikan API respondió ${res.status}`);

const gif = await res.json();
await interaction.reply({
  embeds: [{ image: { url: gif.url }, footer: { text: gif.anime ?? 'Mikan API' } }],
});

import os, aiohttp, discord

headers = {"Authorization": f"Bearer {os.environ['MIKAN_API_KEY']}"}

async with aiohttp.ClientSession(headers=headers) as session:
    async with session.get("/v1/gifs/hug") as res:
        res.raise_for_status()
        gif = await res.json()

embed = discord.Embed().set_image(url=gif["url"])
await interaction.response.send_message(embed=embed)

curl -H "Authorization: Bearer TU_KEY" /v1/frase

Errores y límites

Puedes hacer hasta 60 peticiones por minuto. Las cabeceras RateLimit-Remaining y RateLimit-Reset indican cuántas te quedan y cuándo se reinician.

Contribuir

Mikan crece con los GIFs de su comunidad. Para aportar uno, usa este comando en el servidor de Discord:

/contribuir categoria:hug gif:(tu archivo) anime:Nombre del anime

El staff revisa cada envío. Si se aprueba, el GIF se publica con tu nombre de Discord como crédito y te avisamos por mensaje privado.

Reglas

• GIF, PNG, JPG o WebP de hasta 10 MB. Mejor si pesa menos de 1.5 MB.
• Nada de contenido sexual, ni contenido violento extremo, de odio o de personas reales.
• Que coincida con la categoría y no lleve marcas de agua grandes.
• Hasta 5 envíos en revisión por persona.

Quienes más han aportado

1. Todavía no hay contribuciones. ¡Puedes ser la primera persona!

Preguntas frecuentes

Retirar un GIF

Los personajes y las series que aparecen en los GIFs pertenecen a sus respectivos dueños. Si tienes los derechos de un contenido y quieres que lo retiremos, o ves un GIF inapropiado, únete a nuestro servidor de Discord, abre un ticket con /soporte e indica la URL del GIF.

Términos de uso

Al usar Mikan API o enviar contenido, aceptas lo siguiente.

El servicio

• Mikan API es un proyecto de fans, gratuito y sin relación con Spike Chunsoft ni con los dueños de las series que aparecen en ella.
• Se ofrece tal como está, sin garantía de disponibilidad. Puede cambiar, fallar o dejar de existir en cualquier momento.

Tu uso de la API

• Cada key es personal. No la compartas ni la publiques.
• No intentes saltarte los límites de peticiones, sobrecargar el servicio ni usar varias cuentas para evadir un bloqueo.
• Eres responsable de cómo uses el contenido en tus proyectos, y de cumplir las normas de Discord y las leyes que te apliquen.
• El contenido no tiene licencia para revenderse. Mikan API no te da ningún derecho sobre los personajes, series o GIFs.

Contenido enviado

• Al usar /contribuir, nos permites publicar ese archivo en la API y mostrarlo con tu nombre de Discord, sin pago a cambio.
• Envía solo contenido que cumpla las reglas de esta página. Podemos rechazar o retirar cualquier archivo sin dar explicaciones.

Bloqueos y cambios

• Podemos revocar una key o bloquear a alguien que incumpla estos términos.
• Estos términos pueden cambiar. Si sigues usando la API después de un cambio, se entiende que lo aceptas.

Privacidad

Qué guardamos

• Tu ID de Discord, para vincularlo con tu key.
• Una huella de tu key (hash), no la key en sí. Por eso no podemos recuperarla.
• Datos de uso: cuántas peticiones has hecho y cuándo fue la última.
• Tus contribuciones: los archivos, tu ID y nombre de Discord, la categoría y el anime que indiques.
• Tickets de soporte: quedan como hilos privados en nuestro servidor de Discord.

Para qué lo usamos

Solo para que funcione la API, limitar abusos, revisar contribuciones y darte soporte. No vendemos tus datos ni los usamos para publicidad.

Qué es público

Si se aprueba una contribución tuya, tu nombre de Discord aparece como crédito en la API y en esta página. Tu ID no se publica.

Con quién se comparte

• Railway aloja el servicio y puede registrar datos técnicos como direcciones IP.
• MongoDB Atlas aloja la base de datos.
• Discord gestiona los comandos, los tickets y un canal privado con las copias de seguridad.
• El equipo de staff ve los envíos y los tickets para poder atenderlos.

Cuánto tiempo y cómo borrarlos

• Guardamos tus datos mientras uses el servicio. Las copias de la base de datos se borran a los 30 días.
• Puedes desactivar tu key con /apikey revocar.
• Para borrar tus datos, abre un ticket con /soporte: eliminaremos tu key y tu nombre de las contribuciones. Si estás bloqueado, conservaremos tu ID para mantener el bloqueo.