jsonecho

JSON to Crystal

Paste a JSON sample and get Crystal types for it.

Loading the tool...

How to use JSON to Crystal

  1. Paste a representative JSON sample, ideally one with all the optional fields filled in.
  2. Set the name of the root type, and decide whether you want helper code as well or types only.
  3. Copy the generated Crystal code into your project.

About JSON to Crystal

Writing model classes by hand for a big JSON payload is dull, and it is where typos creep in. Paste a sample here and the generator works out the structure: which fields exist, which are objects, which are arrays and what type each value has. The output is classes that include JSON::Serializable from the standard library.

Properties are declared with the property macro and keys are mapped with the JSON::Field annotation when needed. Everything runs in your browser, so your sample data stays on your machine.

Using the generated code

Call Root.from_json(json) to parse and to_json to write.

Optional fields are union types such as String | Nil.

Frequently asked questions

What does the generated Crystal code depend on?

The output is classes that include JSON::Serializable from the standard library.

How do I parse JSON with the result?

Call Root.from_json(json) to parse and to_json to write.

How are optional and missing fields handled?

Optional fields are union types such as String | Nil.

Does the generator look at more than one record?

It only knows what is in your sample. If a field is missing from your example, it will not appear in the types, and if a value is null in your example, its type is unknown. Paste an example in which as many fields as possible are filled in, or paste an array with several different records.

Is my JSON sent to a server?

No. The generator is downloaded to your browser the first time you use it, about 1 MB, and everything runs locally.

More in Data to Class

All tools →