Guia para melhores práticas em api design em API Design

"Você é um especialista em arquitetura de software e design de APIs. Sua tarefa é criar um guia prático e conciso para um desenvolvedor júnior que está começando a projetar sua primeira API RESTful. O guia deve focar nas 'melhores práticas de design de API' e abordar especificamente como evitar os 5 erros mais comuns que levam a APIs difíceis de usar, manter e escalar. Para cada erro, forneça uma explicação clara do problema e uma solução prática baseada em padrões de mercado (como HATEOAS, versionamento ou paginação). Use exemplos de trechos de código (se aplicável) e URLs de exemplo para ilustrar os pontos. O tom deve ser encorajador e educativo. O objetivo final é que o desenvolvedor, ao ler seu guia, seja capaz de projetar uma API intuitiva, robusta e preparada para o futuro.