Convertidor de JSON a struct de Rust

¿Qué es la conversión de JSON a Rust?

Ejemplos

{"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,
}

Cómo convertir JSON a Rust

1. 1

   Pega tu JSON

   Suelta un objeto JSON, un array o una respuesta de API en el campo de entrada. La conversión empieza al instante.

2. 2

   Ajusta la salida

   Renombra el struct raíz y activa las derivaciones de serde, Debug y Clone, o la visibilidad pub para adaptarlo al estilo de tu crate.

3. 3

   Copia o descarga

   Toma el Rust generado con un clic y pégalo directamente en tu proyecto.

Common Use Cases

Clientes de API tipados

Convierte una respuesta de ejemplo REST o GraphQL en structs de serde para un cliente reqwest o similar sin escribir a mano el código de deserialización.

Análisis de configuración y fixtures

Genera structs para archivos de configuración JSON, fixtures de prueba o payloads de webhooks que necesitas deserializar con serde_json.

Prototipado rápido

Pega un payload desconocido para ver al instante su forma como tipos de Rust — una forma rápida de explorar una nueva API antes de integrarla.

Cómo funciona la conversión

Inferencia estructural

Cada objeto se convierte en un struct con nombre; las formas idénticas se deduplican para que obtengas un solo struct, no copias. Los arrays de objetos se fusionan clave a clave, y las claves ausentes en algunos elementos se convierten en Option<T>.

Tipado numérico correcto

Los enteros se asignan a i64, ascienden a u64 más allá de i64::MAX, y recurren a f64 más allá de u64. Los flotantes se detectan a partir del token (1.0, 2e3) para que la deserialización de serde nunca falle por un flotante en un campo entero.

Identificadores idiomáticos y compilables

Las claves se convierten en campos snake_case con #[serde(rename)] de vuelta a la clave original; las palabras clave de Rust, los nombres duplicados y las claves que no son identificadores se sanean para que la salida siempre compile.

100% del lado del cliente

El análisis y la generación se ejecutan en tu navegador sin llamadas de red, por lo que tus datos siguen siendo privados.

Consejos para structs de Rust limpios

Nombra tu struct raíz

Define un nombre raíz significativo (p. ej. User, ApiResponse) en lugar del Root predeterminado para un código legible.

Añade serde_json solo cuando sea necesario

serde_json::Value aparece para arrays vacíos o de tipos mixtos y campos que solo son null. Da a esos campos un tipo concreto a partir de una muestra más rica si puedes, o añade serde_json a Cargo.toml.

Revisa Option frente a requerido

Los campos se marcan como Option<T> solo cuando una muestra los omite. Pega un payload representativo para que la herramienta infiera con precisión los campos requeridos y opcionales.

Preguntas frecuentes