La API utiliza claves API, que puedes gestionar a través de tu área de cliente.
GET /api/v2/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.
GET https://qconv.com/api/v2/convert.php
| 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 |
| 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 |
rgb
hex
cmyk
pantone
ral
hks
ncs
sw
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:
GET /api/v2/convert.php?from=hex &input=FF0000 &to=rgb &apikey=[SU_CLAVE_API]
{
"api_version" => "v2",
"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": "185",
"ral": "3026",
"hks": "10",
"rgb": "255 0 0",
"hex": "#FF0000",
"cmyk": "0 100 100 0",
"sw": "2910",
"ncs": "S1085-Y90R"
},
"user_data": {
"username": "USER #12345",
"used tokens": 1,
"max tokens": 50,
"percentage used": "2 %"
}
}
GET /api/v2/convert.php?from=rgb &input=145, 25, 100 &to=behr &apikey=[SU_CLAVE_API]
{
"api_version" => "v2",
"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"
},
"user_data": {
"username": "USER #12345",
"used tokens": 2,
"max tokens": 50,
"percentage used": "4 %"
}
}
| 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₀₀ | 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ó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" => "v2",
"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" => "v2",
"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 %"
}
}
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" => "v2",
"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 %"
}
}
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
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
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
Todos los parámetros son insensibles a mayúsculas y minúsculas.
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'.
API-v2:
2025-08-14
API-v1:
2025-07-15