Como usar o modo estrito (Strict mode) via API
O modo estrito (strict mode) é um recurso API que garante que todos os campos obrigatórios sejam fornecidos explicitamente ao criar ou atualizar um perfil. Isso ajuda a evitar erros causados por valores ausentes ou padrão. Quando o modo estrito está ativado, a API exige que todos os campos obrigatórios sejam preenchidos e, caso contrário, você receberá uma mensagem de erro clara informando quais estão faltando.
Modo estrito vs. modo não estrito
Modo não estrito (non-strict)
- Permite deixar campos opcionais em branco: se você não os especificar, o sistema aplica automaticamente os valores padrão
- Esta é a configuração padrão para a maioria dos usuários API e mantém as coisas simples, preenchendo automaticamente os detalhes ausentes
Modo estrito (strict)
- Exige que você especifique todos os campos que a API precisa para criar ou atualizar um perfil
- Se algo estiver faltando, você receberá uma mensagem de erro listando os campos exatos que você precisa preencher
- Isso é útil para usuários que precisam de controle total sobre os dados ou para fins de automação, onde você precisa de todos os parâmetros definidos explicitamente
Por que usar o modo estrito?
- Você precisa de controle total sobre todos os parâmetros do seu perfil
- Você deseja garantir a validação precisa de todos os campos, especialmente para fins de automação e conformidade
- Você prefere mensagens de erro claras e detalhadas quando algo dá errado
- Você precisa de compatibilidade com versões anteriores: não quer mais? É só desativar!
Por que esse recurso é útil?
O modo rigoroso garante que os dados fornecidos sejam completos e precisos, o que é especialmente útil para usuários que trabalham com automação ou que precisam de validação rigorosa para garantir a conformidade. Sem o modo rigoroso, a ausência de campos críticos pode levar a resultados imprevisíveis ou indesejados.
Como habilitar o modo estrito
Para habilitar o modo estrito, adicione o cabeçalho X-Strict-Mode: true
à sua solicitação. Se você não especificar isso, a API usará o modo não estrito por padrão.
💡O que acontece se eu perder um campo ao usar o Modo Estrito?
O sistema retornará uma mensagem de erro detalhada informando quais campos estão faltando. Isso é mais útil do que receber erros para cada campo faltante separadamente.