Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é UUID?

    O UUID identifica registros com 128 bits e métodos padronizados de geração. Cada versão define a composição do valor usado para localizar um recurso.

    Também chamado de: Universally Unique Identifier, GUID

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Formato e métodos de geração

    Um UUID (Universally Unique Identifier) é um identificador de 128 bits usado para distinguir registros ou recursos. Sua representação textual habitual tem 32 caracteres hexadecimais separados por hífens em grupos de 8, 4, 4, 4 e 12 caracteres.

    A versão indica como o identificador foi composto. O UUIDv4 utiliza 122 bits aleatórios e reserva os demais para indicar a versão e a variante do formato. O UUIDv7 inclui o tempo Unix em milissegundos no início do valor. Por isso, dois identificadores com a mesma aparência geral podem ter propriedades diferentes de geração e ordenação.

    O identificador na consulta de um cadastro

    No endereço de exemplo /cadastros/550e8400-e29b-41d4-a716-446655440000, a aplicação usa o UUID para localizar um cadastro. O primeiro caractere do terceiro grupo é 4, que indica a versão 4 nesse formato. A sequência completa seleciona o recurso, mas não informa se você tem permissão para abri-lo.

    Ao receber essa consulta, a API precisa verificar a permissão para abrir o cadastro localizado. O formato válido do UUID não confirma a existência do registro nem substitui a autorização.

    A geração distribuída permite que sistemas criem UUIDs sem consultar um contador central a cada novo registro. Isso exige um gerador adequado à versão escolhida. Ao usar o UUID como chave única, mantenha a restrição correspondente no banco para recusar valores repetidos, inclusive os recebidos de sistemas externos.

    Dúvidas frequentes

    Perguntas frequentes sobre UUID

    Qual é a diferença entre UUIDv4 e UUIDv7?
    A versão 4 reserva 122 bits para valores aleatórios. A versão 7 começa com um instante Unix em milissegundos e combina esse componente com outros bits definidos pelo método de geração.
    Conhecer o UUID autoriza a consulta ao cadastro?
    O UUID apenas identifica o recurso. A aplicação deve verificar a permissão de acesso e não pode usar a posse do identificador como autorização.
    Ainda preciso de uma restrição de unicidade no banco?
    A restrição permite ao banco recusar identificadores repetidos. Ela também cobre duplicações por importação ou por falha da aplicação, além de possíveis colisões na geração.

    Para continuar

    Recursos relacionados

    Documentação

    RFC 9562: UUIDs

    A RFC 9562 especifica o formato dos UUIDs, seus métodos de geração e os cuidados de unicidade e uso em segurança.

    Abrir recurso

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao desenvolver uma API com agentes, você precisa conferir como os registros são identificados e como a aplicação verifica a permissão de acesso.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano