Saltar al contenido principal
GET
/
v1
API de avatares
curl --request GET \
  --url https://avatars.cleariflow.com/v1
El uso de este servicio es sencillo: simplemente proporcione su api_key junto con un name, y el sistema creará una imagen de avatar que corresponde a las iniciales del nombre proporcionado.

​
Primeros pasos

​
REST

La API de avatares sigue el mismo patrón arquitectónico que todos los servicios de Cleariflow, construida en torno a los principios REST. Emplea URL predecibles orientadas a recursos y utiliza códigos de estado HTTP para comunicar errores.

​
HTTPS

La API de avatares exige que toda la transmisión de datos esté protegida mediante protocolos de cifrado TLS 1.2 o superior.

​
Versiones de la API

Cada servicio de Cleariflow incluye versionado. La API de avatares opera actualmente en la versión 1.

​
Su clave API

Su clave API sirve como credencial de autenticación exclusiva para acceder a la API de avatares de Cleariflow. Tenga en cuenta que cada servicio de Cleariflow posee su propia clave API distinta, lo que significa que necesitará claves separadas para distintos servicios como las APIs de avatares y validación de email. Para verificar sus solicitudes, debe incluir su clave API en la URL base.

​
URL base

https://avatars.cleariflow.com/v1/

​
Endpoint de validación

La API de avatares de Cleariflow solo necesita su clave API exclusiva y el nombre del usuario para generar el avatar: 
https://avatars.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& name = Alexander Rodriguez
Esta solicitud se procesó correctamente y el avatar resultante para el nombre especificado aparece a continuación: Avatar para Alexander Rodriguez

​
Parámetros de solicitud

​
api_key
String
requerido
Su clave API exclusiva. Recuerde que cada usuario posee claves API únicas para cada servicio de Cleariflow, por lo que su clave de la API de avatares no funcionará con su API de geolocalización IP, por ejemplo.
​
name
String
requerido
El nombre para el que desea generar un avatar. Puede introducir varios nombres (incluidos nombre, segundo nombre y apellido), y el servicio mostrará automáticamente dos letras en el avatar. Puede modificar el número de letras mediante el parámetro char_limit que se indica a continuación.
​
image_size
Integer
Las dimensiones de la imagen de avatar cuadrada en píxeles. El valor predeterminado es 64 píxeles, con tamaños disponibles que van de 6 a 512 píxeles.
​
image_format
String
El formato preferido para la imagen generada. El valor predeterminado es “png”, pero también puede elegir “svg”.
​
font_size
Float
El tamaño de fuente expresado como porcentaje de image_size. El valor predeterminado es 0,7, con valores aceptables entre 0,1 y 1,0.
​
char_limit
Integer
El número máximo de caracteres a mostrar en el avatar. El valor predeterminado es 2. El número real de caracteres mostrados puede ser menor que este límite, pero nunca mayor. La selección de caracteres prioriza primero las palabras distintas y luego la segunda letra de palabras distintas.
​
background_color
String
El código de color hexadecimal para el fondo. El valor predeterminado es #335eea. Al especificar un color hexadecimal, omita el símbolo ”#”. Por ejemplo, &background_color=e4704a es válido mientras que &background_color=#e4704a no lo es.
​
font_color
String
El código de color hexadecimal para el texto. El valor predeterminado es blanco (ffffff). Al especificar un color hexadecimal, omita el símbolo ”#”. Por ejemplo, &font_color=e4704a es válido mientras que &font_color=#e4704a no lo es.
​
is_rounded
Boolean
Genera una imagen de avatar circular en lugar de cuadrada. El valor predeterminado es false.
​
is_uppercase
Boolean
Convierte todas las iniciales del avatar a mayúsculas. El valor predeterminado es true.
​
is_italic
Boolean
Aplica estilo cursiva a todas las iniciales del avatar. El valor predeterminado es false.
​
is_bold
Boolean
Aplica estilo negrita a todas las iniciales del avatar. El valor predeterminado es false.