Question 1

¿Qué es ClearLogo?

Accepted Answer

ClearLogo es una API de logotipos que devuelve una única imagen limpia para cualquier dominio. A diferencia de las fuentes de logotipos genéricas, se enfoca en la presentación: cada respuesta es consciente del fondo, recortada automáticamente y ajustada en relación, para que los logotipos se vean consistentes dentro de paneles de control, CRM, tablas de empresas y otras superficies de productos.

Question 2

¿Necesito registrarme para probar la API?

Accepted Answer

No. Puedes hacer solicitudes anónimas a https://api.clearlogo.dev/logo/{domain} de inmediato para pruebas de bajo volumen — no se requiere clave. Para tráfico de producción necesitarás una clave de navegador o una clave de servidor desde el panel de control.

Question 3

¿Necesito un servidor backend para usar ClearLogo?

Accepted Answer

No. Una clave de navegador te permite incrustar URLs de logotipos directamente en etiquetas <img> desde código de frontend. Las solicitudes se validan mediante coincidencia de Origin/Referer contra los dominios permitidos que configures en la clave. Usa una clave de servidor solo cuando prefieras autenticación Authorization: Bearer desde tu backend.

Question 4

¿Por dónde empiezo?

Accepted Answer

El camino más rápido: abre el patio de pruebas, pega algunos dominios representativos y ve cómo se ve el resultado en tu interfaz. Una vez que estés satisfecho, crea una clave de producción en el panel de control e intercambia la URL en tu código.

Question 5

¿Cuáles son los mejores casos de uso para ClearLogo?

Accepted Answer

ClearLogo es ideal en cualquier lugar donde los logotipos estén uno al lado del otro y la consistencia visual importe — tablas y directorios de empresas, listas de cuentas CRM, interfaces de enriquecimiento, herramientas de ventas y paneles de control internos. Si solo necesitas un logotipo ocasional detrás de un caché del lado del servidor y la consistencia de presentación no es una preocupación, una fuente genérica puede ser suficiente.

Question 6

¿Cuál es la diferencia entre una clave de navegador y una clave de servidor?

Accepted Answer

Una clave de navegador (pk_…) es segura para incluir en código frontend y etiquetas <img>. Las solicitudes se autentican coincidiendo el encabezado Origin o Referer contra los dominios permitidos que configures. Una clave de servidor (sk_…) se autentica mediante Authorization: Bearer YOUR_KEY desde tu backend y nunca debe exponerse al navegador.

Question 7

¿Cómo restrinjo mi clave de navegador a dominios específicos?

Accepted Answer

En el panel de control, abre la configuración de la clave, habilita Solo dominios permitidos y añade tus dominios uno por línea. Se admite notación de comodín como *.example.com para subdominios.

Question 8

¿Qué sucede con las solicitudes sin encabezado Referer después de que habilito restricciones de dominio?

Accepted Answer

Se bloquean. El tráfico directo y las solicitudes enviadas con Referrer-Policy: no-referrer o same-origin fallarán una vez que las restricciones de dominio estén activas. Las políticas que funcionan incluyen strict-origin-when-cross-origin, origin, origin-when-cross-origin y unsafe-url. Puedes verificar tu configuración buscando el encabezado Referer en solicitudes a img.logo.dev en la pestaña de Red de tu navegador antes de habilitar restricciones.

Question 9

¿Cómo roto o reemplazo una clave de API?

Accepted Answer

Crea una nueva clave en el panel de control, actualiza tu integración para usarla y luego elimina la clave antigua. Si necesitas una rotación urgente, contacta a support@clearlogo.dev.

Question 10

¿Qué formatos de imagen devuelve ClearLogo?

Accepted Answer

png es el predeterminado. Puedes solicitar webp o jpeg mediante el parámetro de consulta format. Cuando se omite format, la API negocia contenido desde el encabezado de solicitud Accept — los navegadores modernos que cargan mediante <img> reciben WebP automáticamente.

Question 11

¿Qué significa salida "consciente del fondo"?

Accepted Answer

ClearLogo detecta si el logotipo de una marca está diseñado para un fondo de color u oscuro y preserva ese fondo en la imagen de respuesta. Esto previene el problema común de logotipos transparentes que se ven rotos en superficies claras.

Question 12

¿Qué tamaños están disponibles?

Accepted Answer

El parámetro size acepta potencias de dos: 16, 32, 48, 64, 96, 128, 192, 256, 512 y 1024 píxeles. La imagen siempre es cuadrada. El predeterminado es 128 px. Los valores fuera de esta lista se ajustan automáticamente al tamaño permitido más cercano (en caso de empate, se elige el superior).

Question 13

¿Qué hace el parámetro `theme`?

Accepted Answer

Establecer theme=dark devuelve la variante de fondo oscuro de un logotipo cuando está disponible. Si no existe variante oscura, la API recurre a la versión estándar.

Question 14

¿Cuáles son los límites de velocidad?

Accepted Answer

Los límites varían según el plan — consulta la página de precios para detalles. El uso por clave se devuelve en los encabezados de respuesta X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para que puedas monitorear el consumo en tiempo real.

Question 15

¿Qué sucede cuando excedo mi límite de velocidad?

Accepted Answer

La API devuelve HTTP 429 con un encabezado Retry-After indicando cuántos segundos esperar antes de reintentar. Nos pondremos en contacto contigo antes de tomar cualquier medida adicional — el servicio no se corta sin previo aviso.

Question 16

¿Cómo compruebo mi uso actual?

Accepted Answer

El uso en tiempo real es visible en el panel de control. También puedes leer el encabezado X-RateLimit-Remaining en cualquier respuesta de la API.

Question 17

Un logotipo no se muestra para un dominio — ¿qué debo verificar?

Accepted Answer

Trabaja a través de esta lista de verificación: (1) confirma que el dominio es un nombre de host sin esquema o ruta, por ejemplo github.com no https://github.com/; (2) verifica que tu clave de API sea válida y no haya expirado; (3) si las restricciones de dominio están habilitadas, verifica que el encabezado Referer se esté enviando; (4) comprueba el código de estado de respuesta — 404 significa que no se encontró logotipo para ese dominio, 401 significa un problema de autenticación, 429 significa limitado por velocidad.

Question 18

El logotipo de un dominio se ve incorrecto u obsoleto — ¿qué puedo hacer?

Accepted Answer

Contacta con nosotros en support@clearlogo.dev con el nombre de dominio y una nota sobre qué se ve incorrecto. Lo revisaremos y actualizaremos el activo.

Question 19

Estoy recibiendo un error 401 — ¿qué significa eso?

Accepted Answer

Un 401 significa que la solicitud no fue autenticada. Para claves de navegador, asegúrate de que se incluya el parámetro de consulta token y que el encabezado Origin/Referer coincida con un dominio permitido. Para claves de servidor, asegúrate de que el encabezado Authorization: Bearer YOUR_KEY esté presente y de que la clave no haya sido eliminada.

Question 20

Los logotipos se cargan en producción pero no durante el desarrollo local — ¿cómo lo arreglo?

Accepted Answer

Añade localhost (o localhost:3000, localhost:5173, etc.) a los dominios permitidos de tu clave en el panel de control. La API coincide con el origen exacto, así que incluye el puerto si tu servidor de desarrollo usa uno no estándar. Elimina las entradas locales antes de distribuir la clave o crea una clave de desarrollo separada.

Question 21

Veo errores CORS en el navegador — ¿cómo lo arreglo?

Accepted Answer

La API establece encabezados CORS permisivos, así que los errores CORS generalmente indican un encabezado Referer faltante o bloqueado en lugar de un verdadero problema de CORS. Comprueba la Referrer-Policy de tu página — políticas como no-referrer previenen que el encabezado Referer se envíe, lo que causará fallos en solicitudes cuando las restricciones de dominio estén activas. También comprueba la etiqueta <img> en sí: un atributo referrerpolicy="no-referrer" o referrerpolicy="same-origin" en el elemento anula la política a nivel de página y elimina Referer de esa solicitud específica.

Question 22

¿Qué planes están disponibles?

Accepted Answer

ClearLogo ofrece un plan gratuito para uso de bajo volumen y planes pagos para tráfico de producción. Consulta la página de precios para los detalles del plan actual y límites de solicitudes.

Question 23

¿Cómo actualizo mi plan?

Accepted Answer

Visita el panel de control y selecciona Actualizar desde tu tarjeta de plan. Serás llevado a la página de facturación donde puedes elegir un plan y completar el pago.

Question 24

¿Puedo cancelar mi suscripción?

Accepted Answer

Sí. Puedes cancelar en cualquier momento desde el panel de control. Tu plan permanece activo hasta el final del período de facturación actual.

Ayuda y FAQ

Primeros pasos

Claves de API y autenticación

Salida y formato

Límites de velocidad y uso

Solución de problemas

Facturación y planes

¿Aún tienes alguna pregunta?