Escolher um formato
Onde o formato vai depende do endpoint:
Enviar um schema
Projetar o schema
Comece com um objeto pequeno. Liste todos os campos emrequired, use enum para categorias conhecidas e defina additionalProperties: false quando chaves extras precisarem ser rejeitadas. Versione o schema junto com o seu validador no servidor para que os dois nunca se afastem.
Validar o resultado
Antes de interpretar, verifique se houve recusa, conteúdo ausente ou resposta truncada (finish_reason diferente de stop). Depois, valide o objeto interpretado. Este validador Zod corresponde ao schema acima: