Conversor JSON para struct Rust

O que é conversão de JSON para Rust?

Exemplos

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub id: i64,
    pub name: String,
    pub email: String,
    pub active: bool,
    pub roles: Vec<String>,
}

{"repo":"serde","owner":{"login":"dtolnay","id":100}}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub repo: String,
    pub owner: Owner,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Owner {
    pub login: String,
    pub id: i64,
}

{"users":[{"id":1,"nick":"x"},{"id":2}]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub users: Vec<User>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct User {
    pub id: i64,
    pub nick: Option<String>,
}

{"login":"octocat","publicRepos":15,"followerCount":9001,"createdAt":"2011-01-25"}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub login: String,
    #[serde(rename = "publicRepos")]
    pub public_repos: i64,
    #[serde(rename = "followerCount")]
    pub follower_count: i64,
    #[serde(rename = "createdAt")]
    pub created_at: String,
}

Como converter JSON para Rust

1. 1

   Cole seu JSON

   Insira um objeto JSON, array ou resposta de API no campo de entrada. A conversão começa instantaneamente.

2. 2

   Ajuste a saída

   Renomeie o struct raiz e alterne os derives serde, Debug e Clone ou a visibilidade pub para combinar com o estilo do seu crate.

3. 3

   Copie ou baixe

   Pegue o Rust gerado com um clique e cole-o diretamente no seu projeto.

Common Use Cases

Clientes de API tipados

Transforme uma resposta de exemplo de REST ou GraphQL em structs serde para um cliente reqwest ou semelhante, sem escrever código repetitivo de desserialização à mão.

Análise de configuração e fixtures

Gere structs para arquivos de configuração JSON, fixtures de teste ou payloads de webhook que você precisa desserializar com serde_json.

Prototipagem rápida

Cole um payload desconhecido para ver sua estrutura instantaneamente como tipos Rust — uma forma rápida de explorar uma nova API antes de integrá-la.

Como a conversão funciona

Inferência estrutural

Cada objeto torna-se um struct nomeado; formatos idênticos são deduplicados, então você obtém um único struct, não cópias. Arrays de objetos são mesclados chave por chave, e chaves ausentes em alguns itens tornam-se Option<T>.

Tipagem numérica correta

Inteiros viram i64, sobem para u64 além de i64::MAX e recorrem a f64 além de u64. Floats são detectados pelo token (1.0, 2e3), então a desserialização do serde nunca falha por uma incompatibilidade de float em inteiro.

Identificadores idiomáticos e compiláveis

As chaves viram campos snake_case com #[serde(rename)] de volta à chave original; palavras-chave do Rust, nomes duplicados e chaves que não são identificadores são saneados, então a saída sempre compila.

100% no lado do cliente

A análise e a geração rodam no seu navegador sem chamadas de rede, então seus dados permanecem privados.

Dicas para structs Rust limpos

Nomeie seu struct raiz

Defina um nome de raiz significativo (por exemplo, User, ApiResponse) em vez do padrão Root para um código legível.

Adicione serde_json apenas quando necessário

serde_json::Value aparece em arrays vazios ou de tipos mistos e em campos que só têm null. Dê a esses campos um tipo concreto a partir de uma amostra mais rica, se possível, ou adicione serde_json ao Cargo.toml.

Revise Option vs. obrigatório

Os campos são marcados como Option<T> apenas quando uma amostra os omite. Cole um payload representativo para que a ferramenta infira com precisão os campos obrigatórios e opcionais.

Perguntas frequentes