Ter um site amigável e voltado para o usuário às vezes pode ser complicado, pois permitiria que toda a equipe de desenvolvimento gastasse mais tempo em coisas que não agregam valor à funcionalidade e ao negócio principal. Ainda assim, pode ajudar o usuário no curto prazo e agregar valor no longo prazo. Os gestores de projetos que são rigorosos com os seus prazos podem subestimar o valor acrescentado a longo prazo. Não tenho certeza se isso é verdade para as equipes de sites da Apple, mas elas estão perdendo uma ótima experiência do usuário.

Recentemente, tentei publicar um aplicativo na app store do site da Apple, mas enfrentei um problema com minhas informações de contato. Embora eu tenha fornecido as informações corretas em vários formatos, ainda precisava aceitá-las e transmitir uma mensagem significativa ao usuário.

Na minha experiência, o site sempre apresenta um erro ao fornecer o número de telefone errado, que parece que este campo é inválido. Aqui está a mensagem geral:

Aqui está a mensagem do próprio campo de entrada:

Tive esse problema mesmo quando tentei com os dois zeros no início, mesmo sem ter adicionado o código do país. Sempre me dava a mesma mensagem de erro, sem nenhuma orientação sobre como consertar isso, o que fazer ou mesmo o que estava errado!

Inicialmente, pensei que fosse um problema com o servidor, então decidi tentar novamente depois de algumas horas. Verifiquei o estado de saúde dos produtos Apple, que não apresentou problemas. Depois de cansado, resolvi depurar o problema como engenheiro de software e verificar o que foi enviado pela rede e qual foi a resposta, o que levou ao "momento Aha" para mim.
Ah! momento, a Apple precisa fornecer a mensagem correta.
Quando verifiquei as mensagens da rede, descobri que elas forneceram os detalhes corretos e o guia do back-end, mas o site não os fornece.

Aqui está a carga útil da solicitação:

A resposta:

{
    "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"
            }
        }
    ]
}

Olhando e lendo os detalhes, pude entender que o problema estava no formato numérico, o que facilitou minha vida.

Um pensamento final:

Como desenvolvedores, devemos conhecer e compreender os problemas dos usuários para escrever uma ótima UI e uma excelente UX para eles. Quando ignoramos a escrita da mensagem correta e mostramos aos usuários como resolver seus problemas sozinhos, sobrecarregamos muito os usuários e nossa equipe de suporte e podemos perder alguns usuários. Isso significa uma perda de receita no longo prazo, o que as empresas não gostam.