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

V1.0 – 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 qConv utiliza claves API, que puedes gestionar a través de tu perfil.

Autenticación mediante parámetro URL

GET /api/v1/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/v1/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 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 a rgb

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

Contesta:

    {
        "from": "hex",
        "input": "FF0000",
        "to": "rgb",
        "result": "255 0 0",
        "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 %"
        }
    }

rgb a Color del fabricante BEHR

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

Contesta:

    {
        "from": "rgb",
        "input": "145, 25, 100",
        "to": "behr",
        "result": "p120-7 glitterati",
        "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 %"
        }
    }

📦 Estructura de respuesta

Campo Tipo Descripción de la
from string Formato de salida transmitido
input string Valor original transmitido
to string Formato de destino transmitido
result string El resultado convertido
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.

⚠️ 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

📈 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:

{
        "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'.

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