C++ client for the public CEP API http://git.cep.is/cpp/atom?h=main 2026-07-27T23:33:51Z 2026-07-27T23:33:51Z Murilo Ijanc murilo@ijanc.org 2026-07-27T23:33:51Z urn:sha1:2fb251996798798af38903fe535b8d147084a50a A CEP that fails a lookup is rarely random: it is usually someone who knows the city and guessed the number, and the classic guess is the -000 that 957 municipalities never received. The API now names, on the 404 itself, the municipality that CEP would have belonged to, so a caller can say "not found — did you mean somewhere in Areal/RJ?" instead of just "not found". CepNotFound carries it as an optional Faixa. It stays an error: the block is context, not an address, and the range it describes is sparse, which is why it reports a count alongside the first and last CEP that actually exist there rather than the bounds the Correios publish. Parsing it is best-effort on purpose — a missing, empty or malformed block leaves the optional empty, since a 404 is already the answer and reading the hint attached to it must never cost the diagnosis. 2026-07-26T15:28:10Z Murilo Ijanc murilo@ijanc.org 2026-07-26T15:28:10Z urn:sha1:b71faa6e95a0736f1ff171e006b171467b65db90