Cómo gestionar los valores de avatar_url que devuelve WA Lookup

El campo avatar_url es la parte de una respuesta ws_avatar que más a menudo sorprende a una integración, porque puede ser una cadena vacía y porque una URL es algo muy distinto de almacenar que un booleano.

WA Lookup devuelve el campo avatar_url en cada respuesta ws_avatar correcta. El valor es una cadena vacía cuando no hay ninguna URL disponible, por lo que una integración debe almacenarlo por separado del booleano avatar al que acompaña y tratar explícitamente el valor vacío.

Modele el booleano y la URL por separado

El booleano avatar y la cadena avatar_url responden a preguntas distintas: si se detectó un avatar y dónde podría obtenerse. Fusionarlos en una sola columna que admite nulos hace perder la primera respuesta cada vez que falta la segunda, y esa ausencia es un resultado normal, no un caso límite. Con dos columnas, ambas respuestas siguen siendo legibles.

Decida si va a almacenar la URL

Algunas integraciones solo necesitan el booleano; en ese caso, descartar la URL elimina por completo toda una categoría de preguntas sobre conservación de datos. Si decide conservarla, guarde junto a ella la fecha de la verificación, porque la información del perfil cambia y una URL almacenada es una instantánea de lo que era cierto en el momento de la verificación, no una dirección permanente.

Trate la obtención como una cuestión aparte

Obtener aquello a lo que apunta una URL es una operación distinta de ejecutar la verificación, con sus propios modos de fallo y sus propios tiempos. Mantener ambas separadas significa que un problema de obtención nunca parecerá un problema de verificación en sus registros, algo importante cuando intenta averiguar por qué un lote tiene un aspecto extraño.

Trate la ausencia sin ramificaciones por todas partes

Normalice la respuesta una sola vez en el límite de su integración —convierta el campo opcional en una representación explícita que su código entienda— en lugar de comprobar su presencia en cada punto de llamada. Los valores ausentes son lo bastante frecuentes como para que las comprobaciones dispersas se conviertan en la principal fuente de errores evitables.

Preguntas frecuentes

¿Debe almacenarse avatar_url indefinidamente?

Si la almacena, hágalo con la fecha de la verificación, ya que la información del perfil cambia y el valor es una instantánea, no una dirección permanente.

¿Qué indica un avatar_url ausente?

Que el servicio de origen no proporcionó ninguno para esa cuenta en el momento de la verificación. El booleano avatar sigue informando de si se detectó un avatar.

¿La obtención forma parte de la verificación?

No. La verificación devuelve campos; obtener aquello a lo que apunta una URL es una operación independiente con sus propios modos de fallo.