Digite para filtrar os verbetes do Glossário.

    Automação e integrações · Vibe Coding: Do Zero ao MVP

    O que é ponteiro JSON?

    Um ponteiro JSON identifica um valor por segmentos separados por barras. A sintaxe define índices de arrays e escapes para nomes que contêm barra ou til.

    Também chamado de: JSON Pointer

    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

    Um caminho até um valor do documento

    Um ponteiro JSON, ou JSON Pointer, é uma string que identifica um valor específico dentro de um documento JSON. A avaliação parte da raiz do documento e percorre os segmentos separados por / até chegar ao valor indicado.

    Cada segmento seleciona uma propriedade pelo nome quando o valor atual é um objeto. Quando o valor é um array, o segmento indica a posição do elemento, começando em zero. A RFC 6901 define essa sintaxe para identificar valores específicos, sem executar buscas por filtros ou criar propriedades ausentes.

    Da lista de usuários ao nome

    Neste documento de exemplo, a propriedade usuarios contém um array com um objeto:

    {
    "usuarios": [
    { "nome": "Ana" }
    ]
    }

    O ponteiro /usuarios/0/nome seleciona o array usuarios, acessa seu primeiro elemento pelo índice 0 e chega à propriedade nome. O resultado é a string Ana. Já /usuarios/1/nome falha, pois o documento só tem um elemento nesse array.

    Você precisa distinguir uma falha de localização de um valor vazio ou nulo existente no JSON. O programa que usa o ponteiro deve tratar o erro conforme o contrato da integração.

    Barras e til nos nomes das propriedades

    A barra separa os segmentos, então uma propriedade chamada a/b precisa ser indicada por /a~1b. Dentro do segmento, ~1 representa a barra do nome e ~0 representa um til. Assim, /a~0b seleciona uma propriedade chamada a~b.

    A string vazia identifica a raiz inteira. Uma barra isolada, /, seleciona uma propriedade de nome vazio no objeto da raiz. Essa diferença permite representar nomes que uma notação informal de caminhos poderia confundir.

    Dúvidas frequentes

    Perguntas frequentes sobre ponteiro JSON

    Qual é o ponteiro para o documento inteiro?
    A string vazia identifica o documento inteiro. Uma barra isolada identifica uma propriedade cujo nome é vazio, quando ela existe no objeto da raiz.
    O índice de um array pode ter zero à esquerda?
    O primeiro índice é 0. Os demais são escritos sem zeros à esquerda, como 1 e 12. Um segmento 01 não é um índice válido de array.
    Uma propriedade inexistente é criada pelo ponteiro?
    O ponteiro apenas identifica um valor. Quando uma etapa não encontra o valor correspondente, a avaliação falha. A aplicação que usa o ponteiro define como tratar esse erro.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao integrar aplicações, você precisa localizar o campo esperado no JSON e tratar caminhos que não existem na resposta.

    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