ApiBrasil.Core.JSON (APIBrasil v0.0.1)

Codec JSON da SDK — sem dependência obrigatória.

O codec é escolhido em tempo de execução, na primeira chamada, e fica memorizado em :persistent_term:

Só é preciso adicionar o :jason ao projeto em versões anteriores a Elixir 1.18 / OTP 27.

Summary

json()

Termo compatível com JSON: mapa, lista, string, número, booleano ou nil.

codec_name()

Informa qual codec está em uso — Jason, JSON ou :json.

decode(binary)

Decodifica uma string JSON.

encode!(term)

Codifica um termo em JSON.

@type json() :: map() | list() | String.t() | number() | boolean() | nil

Termo compatível com JSON: mapa, lista, string, número, booleano ou nil.

@spec codec_name() :: module() | :json

Informa qual codec está em uso — Jason, JSON ou :json.

Útil para diagnosticar o ambiente.

@spec decode(binary()) :: {:ok, json()} | {:error, term()}

Decodifica uma string JSON.

Objetos viram mapas com chaves binárias — o mesmo formato em todos os codecs suportados.

@spec encode!(term()) :: binary()

Codifica um termo em JSON.

Levanta se o termo não for serializável.