Ahora periodo de oferta NUESTRA API SE HA AMPLIADO

Nueva API V3.0: Consiga nuestra API a un precio especial. Acceda ahora. Utilice resultados de conversión de color más detallados: perfecto para proyectos web, plugins, herramientas internas o aplicaciones SaaS. Válido desde 2025-10-21 hasta 2025-11-21 (23:59 CET) inclusive

Paquetes API y precios X

V3.0 Nuevo – qConv.com Converter - Documentación de la API

Con la API qConv Converter API puedes convertir colores entre diferentes formatos - incluyendo RGB, HEX, CMYK, PANTONE®, RAL, HKS, NCS y paletas personalizadas de fabricantes.

🔑 Autenticación

La API utiliza claves API, que puedes gestionar a través de tu área de cliente.

Autenticación mediante parámetro URL

GET /api/v3.0/convert.php?from=hex&input=FF0000&to=ral&apikey=[SU_CLAVE_API]

Nota: La clave está codificada en Base64URL (compatible con URL) y es segura.

🔗 Punto final

GET https://qconv.com/api/v3.0/convert.php

📥 Parámetros de consulta

Parámetros Tipo Requerido Descripción de la
from string ✅ Sí Formato de origen del color, por ejemplo, rgb, ral o nombres de fabricantes como behr.
input string ✅ Sí Valor de entrada, por ejemplo FF0000
to string ✅ Sí Formato de destino del color, por ejemplo hex, cmyk o nombre del fabricante como Caparol Color.
apikey string ✅ Sí Su clave API personal y secreta

Formatos admitidos

Formatos en color

rgb hex cmyk pantone ral hks ncs sw

+ Colores del fabricante

Todos los códigos de fabricante que puede encontrar en las páginas de los fabricantes en el siguiente enlace también son valores válidos.

https://qconv.com/es/empresas

Busque la referencia código API en la columna de la izquierda de la página web del fabricante. O busque el siguiente símbolo:

✅ Ejemplo de consulta

Hex a rgb

GET /api/v3.0/convert.php?from=hex&input=FF0000&to=rgb&apikey=[SU_CLAVE_API]

Contesta:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "hex",
    "input": "ffa500",
    "to": "rgb",
    "result": "255 165 0",
    "name": "Orange",
    "more_conversions": {
        "pantone": "137",
        "ral":     "1028",
        "hks":     "5",
        "rgb":     "255 165 0",
        "hex":     "#FFA500",
        "cmyk":    "0 35 100 0",
        "sw":      "6905",
        "ncs":     "S0580-Y30R",
        "hsl":     "38.82 1 0.5",
        "lab":     "74.93 23.94 78.96"
    },
    "user_data": {
        "username": "USER #12345",
        "used tokens": 1,
        "max tokens": 50,
        "percentage used": "2 %"
    }
}

rgb a Color del fabricante BEHR

GET /api/v3.0/convert.php?from=rgb&input=145, 25, 100&to=behr&apikey=[SU_CLAVE_API]

Contesta:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "rgb",
    "input": "145, 25, 100",
    "to": "behr",
    "result": "p120-7 glitterati",
    "deltaE00": "11.2"
    "match_percent": "93.1%",
    "more_conversions": {
        "pantone": "7649",
        "ral": "4006",
        "hks": "28",
        "rgb": "145 25 100",
        "hex": "#911964",
        "cmyk": "0 83 31 43",
        "sw": "6842",
        "ncs": "S3055-R30B",
        "hsl": "322.5 0.71 0.33",
        "lab": "33.21 53.97 -13.06"
    },
    "user_data": {
        "username": "USER #12345",
        "used tokens": 2,
        "max tokens": 50,
        "percentage used": "4 %"
    }
}

📦 Estructura de respuesta

Campo Tipo Descripción de la
api_version string Devuelve la versión utilizada actualmente de la API, por ejemplo 'v2'.
timestamp string Marca de tiempo de la solicitud en formato ISO 8601, por ejemplo '2025-08-14T13:42:00+01:00'.
http_response_code string Código de estado HTTP de la respuesta (por ejemplo, 200, 400, 500). Indica si la solicitud se ha realizado correctamente o ha devuelto un error.
from string Formato de salida transmitido
input string Valor original transmitido
to string Formato de destino transmitido
result string El resultado convertido
name string/null Designación del color para Sherwin Williams, NCS (alemán), HEX (si está disponible), RGB (si está disponible)
deltaE00 string/null Diferencia entre los colores como valor DeltaE2000 (ΔE₀₀). Encontrará más explicaciones sobre Delta E 2000 o dE₀₀ en la tabla siguiente.
match_percent string/null Nota sobre la coincidencia de colores cuando se busca el color del fabricante coincidente en porcentaje. EJ: 'match_percent': '92.2%',
Sólo salida al convertir a colores de fabricante.
more_conversions object Todas las demás conversiones paralelas disponibles como matriz
user_data object Información sobre su cuenta API, como el número de conversiones utilizadas.
error string Si se produce un error: Objeto con más detalles, como el código de error, la descripción, etc. Si la consulta se realiza correctamente, este campo es cero o no está presente.

ΔE₀₀ y el significado de los valores.

ΔE₀₀ Descripción Perceptibilidad humana
< 0.5 Imperceptible La diferencia de color no es visible para el ojo humano.
0.5 – 1.0 Desviación muy baja La diferencia de color sólo es perceptible en condiciones de laboratorio.
1.0 – 2.0 Desviación menor La diferencia de color es apenas visible y, en general, aceptable.
2.0 – 3.0 Desviación perceptible La diferencia de color es visible en comparación directa.
3.0 – 5.0 Desviación significativa La diferencia de color es claramente visible, posiblemente problemática.
> 5.0 Fuerte desviación Tan diferentes como dos colores distintos.
Para más información sobre ΔE₀₀, Delta E 2000 o dE₀₀, pulse aquí.: DELTA E 2000 WIKI

⚠️ Códigos de error

Código de estado Significado
400 Parámetro ausente o no válido
401 Clave API no válida o inexistente
429 Límite mensual de API alcanzado
500 Error interno del servidor

Si falta la clave API o se ha introducido una clave API incorrecta:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 401,
    "error": "Unauthorized",

}

Si falta una entrada o se introduce un valor no conforme:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 400,
    "error": "Missing input, from or to" | "Conversion failed or input invalid",
    "user_data": {
        "username": "USER #12345",
        "used tokens": 50,
        "max tokens": 50,
        "percentage used": "100 %"
    }
}

📈 Límites de API y facturación

Cada clave API tiene un límite mensual fijo. Gratis son 50 tokens al mes por clave API. Se pueden crear hasta dos API-KEYs de forma gratuita.

Esto se puede ampliar mediante actualizaciones:
Con la tarifa Basic-API se pueden crear 5 API-KEYs con 200 tokens cada una (∑ 1.000 tokens).Con la tarifa Premium API puede crear 10 API-KEYs con 1. 000 tokens (∑ 1. 000 tokens).000 tokens (∑ 10.000 tokens).
Con la tarifa Voyager API, puede crear 50 API-KEYs con 10.000 tokens cada una (∑ 500.000 tokens).
Si tiene requisitos especiales, también podemos preparar ofertas personalizadas en cualquier momento. No dude en ponerse en contacto con nosotros.

Cuando se alcanza el límite:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 429,
    "error": "Hello USER #12345, your monthly API quota of 50 requests has been used up. Please contact [email protected] to upgrade or wait for the next reset.",
    "user_data": {
        "username": "USER #12345",
        "used tokens": 50,
        "max tokens": 50,
        "percentage used": "100 %"
    }
}

🛠️ Gestor de API

Gestión de claves API (añadir/eliminar)

Ver el uso total y el relacionado con la API

Aumentar los límites mensuales mediante actualizaciones

Generar nuevas claves (Base64URL-safe)

Añadir comentarios para una mejor diferenciación

🔒 Seguridad

Todos los parámetros se envían a través de GET

Limitación de velocidad por tecla opcional

Clave Base64URL de 32 bytes de longitud

🧼 Notas para desarrolladores

Todos los parámetros son insensibles a mayúsculas y minúsculas.

El código hexadecimal no es posible con #: Sólo FF0000 son válidos

255,0,0 o 255 0 0 para RGB

185C y 185 C funcionan para PANTONE

Ayuda

Nota: Por razones técnicas, puede ocurrir que no se emita ningún resultado para algunos nombres de fabricantes. Si necesita ayuda o su conversión no funciona por cualquier otro motivo, póngase en contacto con nosotros en info[at]qconv.com. Ofrecemos soporte para clientes del 'Servicio API Básico'.

🆕 Registro de cambios

API-V3.0:

  • NUEVO: Ahora es posible obtener los respectivos colores relacionados como complementarios, más claros, más oscuros, más cálidos, más fríos, etc. para los colores transmitidos. Para ello hemos creado /api/color.php.
  • Color LAB y HSL integrado en la respuesta
  • En el objeto user_data hemos normalizado el identificador 'used tokens' con un guión bajo.
    NUEVO: 'used_tokens'
  • En el objeto user_data hemos normalizado el identificador 'max tokens' con un guión bajo.
    NUEVO: 'max_tokens'
  • En el objeto user_data hemos normalizado el identificador 'percentage used' con un guión bajo.
    NUEVO: 'percentage_used'

2025-10-21

API-V2.0:

  • Al convertir al fabricante, las diferencias de color también se muestran ahora como valores de diferencia de color en formato dE00 (Delta E 2000).
  • Si existe una designación de color (Sherwin Williams, NCS (alemán), HEX o RGB), ésta se emite
  • También se muestran el número de versión de la API y la fecha y hora.
  • Si la entrada es incorrecta, se devuelve más información

2025-08-14

API-V1.0:

  • API integrada en el sitio web

2025-07-15

Para guardar estas paletas de color, tendrá que iniciar una sesión personal.

Acceda a su cuenta

o

Crear una cuenta

Paleta de colores actual Compartir
¿Debe ser público o privado?
Enlace(s) después de compartir.

Cancelar Compartir

Paleta de colores compartida
Por favor, copie y guarde el enlace deseado.

Compartir

OK, he copiado los enlaces

Tus colores se guardarán en una nueva paleta de colores.
Consúltala en tu perfil.
Puedes personalizarla aún más y compartirla.

Mostrar paleta de colores
Cerrar

Crea una paleta de colores

DescargarDescargar en varios formatos

Eliminar todo

Haciendo clic en puede crear paletas y descargar las muestras de color.