UUID e timestamp em integrações

Saiba por que esses valores aparecem tanto em APIs e como testá-los corretamente.

UUID e timestamp aparecem em quase todas as integrações modernas. Um identifica eventos e entidades; o outro posiciona acontecimentos no tempo.

UUID como identificador

UUID v4 é aleatório e costuma ser representado por 36 caracteres com hifens. Em testes, confira formato, unicidade dentro da amostra e consistência entre requisição, resposta e persistência.

Timestamp e fuso horário

Defina no contrato se o valor está em segundos ou milissegundos e qual fuso será usado. ISO 8601 com UTC, como 2026-07-15T12:00:00Z, reduz ambiguidades.

Cenários importantes

• Virada de dia, mês e ano.
• Ano bissexto.
• Datas no passado e no futuro.
• Ordem dos eventos e atrasos de processamento.
• Conversão entre UTC e horário local.

Ferramentas relacionadas

Use os utilitários do QA Tools para preparar exemplos e verificar formatos diretamente no navegador.