Tener un sitio web fácil de usar y orientado al usuario puede ser complicado a veces, ya que permitiría que todo el equipo de desarrollo dedicara más tiempo a cosas que no agregan valor a la funcionalidad y al negocio principal. Sin embargo, puede ayudar al usuario a corto plazo y agregar valor a largo plazo. Los directores de proyecto que son estrictos con sus plazos podrían subestimar el valor añadido a largo plazo. No estoy seguro de si esto es cierto para los equipos del sitio web de Apple, pero se están perdiendo una excelente experiencia de usuario.

Recientemente, intenté publicar una aplicación en la tienda de aplicaciones desde el sitio web de Apple, pero tuve un problema con mi información de contacto. Aunque proporcioné la información correcta en varios formatos, aún necesitaba aceptarlos y enviar un mensaje significativo al usuario.

En mi experiencia, el sitio web siempre les da un error por proporcionar el número de teléfono incorrecto, que se lee como si este campo no fuera válido. Aquí está el mensaje general:

Aquí está el mensaje del campo de entrada:

Tuve este problema incluso cuando intenté con los dos ceros al principio, incluso si no agregué el código de país. ¡Siempre me daba el mismo mensaje de error, sin instrucciones sobre cómo solucionarlo, qué hacer o incluso qué estaba mal!

Al principio, pensé que era un problema con el servidor, así que decidí intentarlo de nuevo después de unas horas. Verifiqué el estado de salud de los productos Apple y no hubo ningún problema. Después de estar cansado, decidí depurar el problema como ingeniero de software y verificar qué se envió a través de la red y cuál fue la respuesta, lo que me llevó al "momento Aha".
¡Ajá! En este momento, Apple necesita proporcionar el mensaje correcto.
Cuando revisé los mensajes de la red, descubrí que proporcionaban los detalles correctos y la guía desde el backend, pero el sitio web no los proporciona.

Aquí está la carga útil de la solicitud:

La respuesta:

{
    "errors": [
        {
            "id": "SOME-GUID",
            "status": "409",
            "code": "ENTITY_ERROR.ATTRIBUTE.INVALID",
            "title": "An attribute value is invalid."
            "detail": "The phone number must be in a valid format. Preface the phone number with ‘ ’ followed by the country code (for example,  44 844 209 0611)",
            "source": {
                "pointer": "/data/attributes/contactPhone"
            }
        }
    ]
}

Al mirar esto y leer los detalles, pude entender que el problema estaba en formato numérico, lo que me hizo la vida más fácil.

Una reflexión final:

Como desarrolladores, debemos conocer y comprender los problemas de los usuarios para escribir una excelente UI y una excelente UX para ellos. Cuando ignoramos escribir el mensaje correcto y mostramos a los usuarios cómo resolver sus problemas por sí mismos, les ponemos mucha carga a los usuarios y a nuestro equipo de soporte, y podríamos perder algunos usuarios. Esto significa una pérdida de ingresos a largo plazo, lo que no gusta a las empresas.