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
API-V1.0 API-V2.0 API-V3.0 Nuevo

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

Convert-API V3.0 Color-API V3.0 Nuevo

Con la API de colores relacionados de qConv puede obtener colores coincidentes de su color de origen, incluidos RGB, HEX, CMYK, PANTONE®, RAL, HKS, NCS y paletas de fabricantes personalizadas.
IMPORTANTE: Para fabricantes o paletas de colores como RAL, Pantone, etc., siempre se devuelve el color de paleta coincidente más cercano.

🔑 Autenticación

La API qConv utiliza claves API, que puedes gestionar a través de tu perfil.

Autenticación mediante parámetro URL

GET /api/v3.0/color.php?from=hex&input=FF0000&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/color.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
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 son valores válidos.

https://qconv.com/es/empresas

Busque la referencia código API o este símbolo en la columna de la izquierda de la página web del fabricante:

✅ Ejemplo de consulta

Hex

GET /api/v3.0/color.php?from=hex&input=FF0000&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",
    "related": {
        "comp": {
            "rgb": "0 255 255",
            "hex": "#00FFFF",
            "cmyk": "100 0 0 0",
            "hsl": "180 1 0.5",
            "lab": "91.12 -48.08 -14.14"
        },
        "dark": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "light": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "ana": [
            {
                "rgb": "255 0 136",
                "hex": "#FF0088",
                "cmyk": "0 100 47 0",
                "hsl": "328 1 0.5",
                "lab": "55.11 85.15 -0.4"
            },
            {...},
            {...}
        ],
        "mono": [
            {
                "rgb": "172 0 0",
                "hex": "#AC0000",
                "cmyk": "0 100 100 33",
                "hsl": "0 1 0.34",
                "lab": "35.54 59.64 49.89"
            },
            {...},
            {...}
        ],
        "warm": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "cold": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "sat_more": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            }
        ],
        "sat_less": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "split": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "triad": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "tetrad": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "square": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ]
    },
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 1,
        "max_tokens": 50,
        "percentage_used": "2 %"
    }
}

Color del fabricante BEHR

GET /api/v3.0/color.php?from=behr&input=p120-7 glitterati&apikey=[SU_CLAVE_API]

Contesta:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "behr",
    "input": "p120-7 glitterati",
    "related": {
        "comp": {
            "manufacturer": "Behr",
            "name": "mq6-41 farmer´s market",
            "rgb": "113 184 151",
            "hex": "#71B897",
            "cmyk": "39 0 18 28",
            "hsl": "152.11 0.33 0.58",
            "lab": "69.49 -29.81 9.81"
        },
        "dark": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "light": [
            {
                "mfg": "Behr",
                "name": "ppu1-16 haitian flower",
                "rgb": "151 73 90",
                "hex": "#97495A",
                "cmyk": "0 52 40 41",
                "hsl": "346.92 0.35 0.44",
                "lab": "41.35 34.47 5.42"
            },
            {...},
            {...}
        ],
        "ana": [
            {
                "mfg": "Behr",
                "name": "p110-7 xoxo",
                "rgb": "145 80 123",
                "hex": "#91507B",
                "cmyk": "0 45 15 43",
                "hsl": "320.31 0.29 0.44",
                "lab": "43.04 33.27 -12.51"
            },
            {...},
            {...}
        ],
        "mono": [
            {
                "mfg": "Behr",
                "name": "bxc-21 chicory root",
                "rgb": "95 66 63",
                "hex": "#5F423F",
                "cmyk": "0 31 34 63",
                "hsl": "5.63 0.2 0.31",
                "lab": "31.09 12.12 6.83"
            },
            {...},
            {...}
        ],
        "warm": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "cold": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "sat_more": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "sat_less": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "split": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "triad": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "tetrad": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "square": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ]
    },
    "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
related object El campo relacionados contiene los tonos de color asociados que se calculan a partir del color transferido. Estos incluyen colores complementarios, variantes más claras y más oscuras y armonías de color como tríada o tétrada. Para más información: Relacionados en detalle.
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.

En detalle

Tipo de color Tipo Descripción de la
comp object El color complementario, es decir, el color opuesto en la rueda cromática.
dark array Una gradación de hasta cinco variantes más oscuras del color original.
light array Una gradación de hasta cinco variantes más claras del color.
ana array Hasta cinco tonos de color próximos en la rueda cromática.
mono array Hasta cinco variaciones monocromáticas del mismo color básico con diferentes brillos o saturaciones.
warm array Hasta cinco variantes más cálidas del color: tonos ligeramente desplazados hacia el rojo o el amarillo.
cold array Hasta cinco variantes más frías del color: tonos más azulados o violáceos.
sat_more array Hasta cinco colores con mayor saturación cromática (efecto más fuerte e intenso).
sat_less array Hasta cinco colores con saturación reducida (efecto apagado, más sobrio).
split array Tres colores del esquema complementario dividido: dos tonos que están junto al color complementario.
triad array Combinación de colores triádica: tres colores distribuidos uniformemente en la rueda cromática.
tetrad array Combinación tetrádica: cuatro colores que forman un rectángulo en la rueda cromática.
square array Combinación de colores cuadrados: cuatro colores con el mismo espacio en la rueda cromática.

Cada objeto contiene los siguientes valores

Valores cromáticos Tipo Descripción de la
mfg string / null Nombre del fabricante de la pintura, si está disponible (por ejemplo, Behr, OBI, RAL).
name string / null Designación oficial del color del fabricante, si está disponible.
rgb string Valores RGB, separados por espacios (por ejemplo, '113 184 151').
hex string Código de color hexadecimal (por ejemplo, '#71B897').
cmyk string Representación CMYK (valores porcentuales para aplicaciones de impresión o diseño).
hsl string Tono de color, saturación y luminosidad (Hue, Saturation, Lightness).
lab string Valores en el espacio de color CIELAB, adecuados para comparaciones y análisis precisos del color.

⚠️ 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 or from" | "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. Gratis son 50 tokens al mes por clave API. Se pueden crear hasta dos API-KEYs gratuitas.

Esto se puede ampliar con 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 muestren resultados para algunos nombres de fabricantes. Si necesita ayuda o su conversión no funciona por cualquier otro motivo no mencionado, póngase en contacto con nosotros en info[at]qconv.com. Ofrecemos asistencia a los 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:

  • Las diferencias de color ahora también se muestran como un valor de diferencia de color en formato dE00 (Delta E 2000) al convertir al fabricante.
  • 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 ofrece información más detallada sobre el motivo.

2025-08-14

API-V1.0:

  • API integrada en el sitio web

2025-07-15

Para poder guardar paletas de colores, es necesario registrarse.

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 guardan en una nueva paleta de colores.
Consúltalos en tu perfil.
Puedes personalizarlos aún más y compartirlos.

Mostrar paleta de colores
Cerrar

Crear una paleta de colores

DescargarDescargar en varios formatos

Eliminar todo

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

© 2019-2025 - Designed by frag-bobby.de