La API utiliza claves API, que puedes gestionar a través de tu área de cliente.
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.
GET https://qconv.com/api/v1/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/en/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/v1/convert.php?from=hex &input=FF0000 &to=rgb &apikey=[SU_CLAVE_API]
{
"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 %"
}
}
GET /api/v1/convert.php?from=rgb &input=145, 25, 100 &to=behr &apikey=[SU_CLAVE_API]
{
"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 %"
}
}
| 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ó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 |
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:
{
"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 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 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'.GET
🧼 Notas para desarrolladores
FF0000 son válidosAyuda