Documentación

Autenticación

Para acceder a la API, necesitas una API Key. Puedes solicitarla desde nuestro panel de control.

Las API Keys garantizan el acceso seguro y limitado a la API. Solo los usuarios registrados pueden obtener una.

Si intentas hacer una petición sin una API Key válida, recibirás un error 401 Unauthorized.

fetch('https://apikarl.com/api/memes', {
  headers: {
    'Authorization': 'Bearer TU_API_KEY_AQUI'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Seguridad

Tu API Key es única y no debe compartirse. Guárdala de forma segura y nunca la incluyas en código cliente expuesto.

Límites

Cada API Key tiene límites de uso para garantizar el servicio. Contacta para aumentar tus límites.

Solicitar API Key

Endpoints

Los endpoints permiten acceder a distintas funciones de la API Karl. Cada endpoint está diseñado para una función específica y optimizado para un rendimiento máximo.

Todos los endpoints retornan datos en formato JSON y aceptan parámetros mediante query strings o en el cuerpo de la petición en formato JSON.

/api/memes – Devuelve imágenes de memes populares con posibilidad de filtrar por categorías.
/api/chistes – Responde con chistes aleatorios en diferentes idiomas y categorías.
/api/moderacion – Comandos de moderación para servidores de Discord con opciones avanzadas.
/api/usuarios – Obtiene información detallada de usuarios de Discord incluyendo estadísticas.
/api/anime – Información y recursos sobre anime, incluyendo imágenes y datos.
/api/minigames – Minijuegos integrados para diferentes plataformas.

import requests

response = requests.get(
    'https://apikarl.com/api/chistes',
    headers={'Authorization': 'Bearer TU_API_KEY_AQUI'},
    params={'categoria': 'tecnologia', 'idioma': 'es'}
)

data = response.json()
print(data['chiste'])

Ver todos los Endpoints

Manejo de errores

Si algo sale mal, la API devolverá códigos de error con mensajes descriptivos para facilitar la solución de problemas.

400 – Solicitud incorrecta. Verifica los parámetros y formato de la petición.
401 – API Key inválida o faltante. Revisa tu autenticación.
403 – No tienes permiso para acceder a este recurso con tu nivel actual.
404 – El recurso solicitado no existe o ha sido removido.
429 – Has excedido el límite de peticiones. Espera antes de intentar nuevamente.
500 – Error interno del servidor. Por favor repórtalo a nuestro equipo.

{
  "error": true,
  "codigo": 400,
  "mensaje": "Parámetro 'categoria' no válido",
  "sugerencias": ["tecnologia", "deportes", "general"],
  "documentacion": "https://apikarl.com/docs/errores"
}

Para evitar errores, revisa la documentación antes de hacer peticiones y siempre maneja los posibles errores en tu código.

Estado del Servicio

Puedes verificar el estado actual de nuestra API en tiempo real en nuestro panel de estado.

Soporte

¿Tienes problemas? Nuestro equipo de soporte está disponible 24/7 en nuestro servidor de Discord.

Guía de Solución de Problemas

Ejemplos de integración

Implementa API Karl en tus proyectos con estos ejemplos prácticos en diferentes lenguajes.

const axios = require('axios');

async function getRandomMeme() {
  try {
    const response = await axios.get('https://apikarl.com/api/memes/random', {
      headers: {
        'Authorization': 'Bearer TU_API_KEY_AQUI'
      }
    });
    
    return response.data;
  } catch (error) {
    console.error('Error obteniendo meme:', error.response?.data || error.message);
    return null;
  }
}

// Uso
getRandomMeme().then(meme => {
  if (meme) {
    console.log(`Título: ${meme.titulo}`);
    console.log(`URL: ${meme.url}`);
  }
});

Disponemos de librerías oficiales para integrar API Karl en diferentes plataformas y lenguajes:

JavaScript

Instala con NPM: npm install apikarl

Python

Instala con PIP: pip install apikarl

Java

Disponible en Maven Central

PHP

Instala con Composer: composer require apikarl/apikarl

Ver más ejemplos

Endpoints de Utilidad

Nuestra colección de endpoints de utilidad proporciona herramientas potentes para mejorar la funcionalidad de tus aplicaciones y servidores de Discord.

🚀 Boost Card

Genera una imagen de un boost con detalles personalizables.

Parámetros: avatar, username, background, avatarposicion, usernameposicion

🌍 Traductor

Convierte texto a diferentes idiomas en segundos.

Parámetros: texto, idioma

🎉 Bienvenida

Crea una imagen de bienvenida para nuevos usuarios en tu servidor.

Parámetros: avatar, texto1, texto2, texto3, background (OPCIONAL: color, texto1posicion, texto2posicion, texto3posicion, avatarposicion)

📌 Texto a QR

Convierte cualquier texto en un código QR para compartir fácilmente.

Parámetros: texto

🏆 Carta Ranked

Genera una tarjeta con estadísticas de nivel de usuario en juegos o servidores.

Parámetros: avatar, username, xp, maxxp, nivel, background

📈 Carta Subida Ranked

Genera una imagen mostrando la subida de nivel o rango en un sistema de ranking.

Parámetros: avatar, username, nivel actual, nivel proximo, background

🤖 Roblox Data

Obtén información detallada de un usuario, grupo, inventario o más de Roblox.

Parámetros: usuario (OPCIONAL: foto=true para capturar pantalla)

✅ Verificación Roblox

Comprueba si la descripción de un usuario de Roblox coincide con la proporcionada.

Parámetros: id, descripcion

📷 Screenshot

Toma fotos a las páginas web.

Parámetros: url (opcional: dimension)

🤖 Deepseek

Observa las respuestas de una AI.

Parámetros: prompt (opcional: rol)

🏡 IP

Obtén información por IP.

Parámetros: (opcional: ip)

🟥 YouTube

Obtén información de canales.

Parámetros: channel=nombre_canal (opcional: tipo=reciente,famoso,short_reciente,short_famoso,tiktok,foto=si)

☁️ Clima

Obtén información meteorológica actualizada para cualquier ubicación.

Parámetros: ciudad, pais (opcional: idioma=es,en,fr)

🔗 Acortador URL

Convierte URLs largas en enlaces cortos y fáciles de compartir.

Parámetros: url

Ver detalles completos

Endpoints de Diversión

Nuestra colección de endpoints de diversión añade elementos interactivos y entretenidos a tus aplicaciones y servidores.

💋 Kiss

Genera 100 imágenes de anime besándose aleatoriamente.

Parámetro opcional: json=true

❤️ Ship

Crea una carta de ship entre dos personas con 5 imágenes de fondo.

Parámetros: avatar1, avatar2

✋ Slap

Genera 100 imágenes de anime dando golpes (slaps).

Selección aleatoria.

🚔 Jail

Genera una imagen colocando a un usuario en prisión.

Parámetros: avatar1

🎵 Lyric

Obtiene la letra de cualquier canción.

Parámetros: música

✨ MAGIK

Aplica efectos de distorsión mágica a cualquier imagen.

Parámetros: imagen, nivel (opcional: 1-10)

⚪⚫ Blanco y Negro

Convierte cualquier imagen a blanco y negro con ajustes de contraste.

Parámetros: imagen, contraste (opcional: 1-5)

🔄 Invertido

Invierte los colores de cualquier imagen creando un efecto negativo.

Parámetros: imagen

😂 Meme Generator

Crea memes personalizados con plantillas populares o tus propias imágenes.

Parámetros: plantilla (o imagen), textoArriba, textoAbajo

🎬 GIF Search

Busca y obtén GIFs divertidos y relevantes para cualquier situación.

Parámetros: busqueda, limite (opcional: 1-25)