d/source, branch mainD client for the public CEP API
http://git.cep.is/d/atom?h=main2026-07-27T23:37:09ZCarry the municipality a missing CEP would belong to2026-07-27T23:37:09ZMurilo Ijancmurilo@ijanc.org2026-07-27T23:37:09Zurn:sha1:a891657aa43d2aba06a6347dd2f94edd19afd6ba
A 404 is rarely a random number: it is usually someone who knows the city
and guessed the digits, and the classic guess is the -000 that 957
municipalities never received. The API now attaches a faixa to the
not-found body naming the municipality that owns the range, so the caller
can say "no such CEP, but that range is Areal/RJ" instead of only "no".
It stays an error. Faixa hangs off CepNotFoundException, never off
Address, and parsing is deliberately lenient: an absent, malformed or
unnamed block yields a null Nullable, so reading the extra context can
never cost the caller the answer it already had.
cep_ini and cep_fim are the smallest and largest CEP that actually exist
there, not the bounds the Correios publish, and the range between them is
sparse — hence ceps, so nobody mistakes the pair for a list.
Initial import2026-07-26T15:47:38ZMurilo Ijancmurilo@ijanc.org2026-07-26T15:47:38Zurn:sha1:794f28199a4dde9d18ec711864336c96c58bb422