typescript, branch mainTypeScript/JavaScript client for the public CEP API
http://git.cep.is/typescript/atom?h=main2026-07-27T23:31:55ZCarry the municipality of a CEP that does not exist2026-07-27T23:31:55ZMurilo Ijancmurilo@ijanc.org2026-07-27T23:31:55Zurn:sha1:4ebb31f26efed74f8fcb049fe27ddf7cf5388a08
A CEP that fails is rarely a random number: it is someone who knows the
city and guessed the digits, and the classic guess is the -000 that 957
municipalities never received. The API now answers the 404 with the
municipality that band belongs to, which is enough to tell the user
"Areal/RJ, but not that number" instead of a bare failure.
It stays an error. Faixa hangs off CEPNotFound rather than becoming a
result, cep_ini/cep_fim are documented as the CEPs that exist there and
not as a range to iterate, and an absent or unreadable block yields
undefined so that context can never cost the caller the clean not-found
it was already getting.
Initial import2026-07-26T15:15:55ZMurilo Ijancmurilo@ijanc.org2026-07-26T15:15:55Zurn:sha1:986a16c34049187a6c1f39f38bfa59e327093494