Preguntas frecuentes¶
Dudas frecuentes sobre la autenticación¶
¿Cuanto dura un token de sesión?
El token de sesión tiene una validez de 24 horas desde que se ha generado.
¿Una vez generado un token de sesión es obligatorio usar ese token hasta que caduque?
El token de sesión está pensado para que se genere solo uno por día y este se renueve. Aun así, esto no es limitante, puede tenerse un token de sesión distinto en cada servidor que esté ejecutando las llamadas al API de PhotoILike y que este token se renueve cada 24 horas.
Aunque no es recomendable, es posible que por diversas razones se tenga que realizar una implementación sencilla para usar los servicios de PhotoILike y se puede generar un nuevo token de sesión cada vez que se analice un grupo de imágenes (aunque eso suponga realizar 200 peticiones al día para 200 tokens de sesión).
Dudas frecuentes sobre client-key¶
¿Por qué el client-key no funciona?
El motivo más habitual por el que un client-key no funciona es porque solo están usando el prefijo del token en lugar de usar el token entero.
¿Cómo se deberían almacenar los client-keys?
Dado que el client-key es un dato sensible, desde PhotoILike recomendamos almacenar todos los client-key en un KMS (Key Management Service).
En caso de que no sea viable usar un KMS y se necesite almacenar una base de datos que limita el tamaño de los strings, recomendamos almacenarlo como si fuese de tipo file, blob u object. Esto se debe a que los client-keys generados no tienen por qué tener siempre el mismo tamaño. Actualmente, cuentan con un tamaño de 358 caracteres pero esta longitud se puede incrementar en un futuro.
Dudas frecuentes sobre la ordenación¶
¿Cómo obtengo el identifier de la imagen para usar el servicio de ordenación?
El identifier es un identificador que no tiene nada que ver con los servicios de PhotoILike así que se puede usar el identificador que se considere oportuno. Los identificadores más habituales a usar son la url donde está alojada la imagen, su identificador de base de datos o el nombre del archivo.
¿Es necesario que use las etiquetas que se emplean en el servicio de PhotoILike?
Aunque en PhotoILike trabajamos muy duro para tener un buen clasificador y lo mejoramos periódicamente, no obligamos a usar nuestro etiquetador. Por esta razón no hace falta usar las etiquetas que usa nuestro servicio, se puede utilizar cualquier etiqueta que desee.
Dudas frecuentes sobre imágenes¶
¿Cuál es el tamaño máximo de imagen permitido?
El tamaño de la imagen no ha de superar los 10MB.
¿Qué formatos de imagen se pueden utilizar?
Actualmente están soportados los formatos jpg
, jpeg
y png
.
De forma experimental se incluyen los formatos webp
, heic
y avif
.
Dudas frecuentes sobre los errores a las llamadas del API¶
¿Por qué las peticiones que hago al API me devuelven el código 403?
Tu usuario no tiene el rol que permite consumir los recursos del API. Puedes ponerte en contacto con el equipo de PhotoILike para solicitarlo a través de este enlace.
¿Cómo consigo que mi usuario tenga el rol necesario para consumir los recursos del API?
Puedes solicitarlo al equipo de PhotoILike a través de este enlace.
Dudas frecuentes sobre como realizar las peticiones¶
¿Es posible realizar peticiones en paralelo para un mismo recurso?
PhotoILike permite el uso de llamadas en paralelo. La siguiente tabla indica el limite de peticiones simultáneas por client-key.
Recurso | Límite |
---|---|
score |
5/sg |
label |
5/sg |
sort |
10/sg |
A continuación puede consultar varios de los ejemplos del uso de peticiones paralelas qué consumen los servicios de PhotoILike: