diff options
Diffstat (limited to 'lib/Cepis.pm')
| -rw-r--r-- | lib/Cepis.pm | 17 |
1 files changed, 15 insertions, 2 deletions
diff --git a/lib/Cepis.pm b/lib/Cepis.pm index 224d80d..1ea5b00 100644 --- a/lib/Cepis.pm +++ b/lib/Cepis.pm @@ -8,10 +8,11 @@ use Exporter 5.57 qw(import); use Cepis::Address; use Cepis::Client; use Cepis::Error; +use Cepis::Faixa; use Cepis::Geo; use Cepis::Health; -our $VERSION = '0.1.0'; +our $VERSION = '0.2.0'; our @EXPORT_OK = qw(lookup lookup_many health normalize_cep); @@ -101,6 +102,18 @@ the lot, and the split below it is by whether retrying helps: } } +A C<CEPNotFound> often knows B<where> the CEP would have been. When the API says +so, C<< $err->faixa >> is a L<Cepis::Faixa> naming the municipality that owns +that band, and the message names it too: + + # "CEP 25845000 does not exist in the DNE database (it would fall in Areal/RJ)" + +It is still a failure — C<faixa> is context for the error, never an address — +and it is C<undef> when the CEP fell in a band no municipality owns. It is worth +checking because a failing CEP is rarely random: it is usually someone who knows +the city and guessed the number, and the classic guess is the C<-000> that 957 +municipalities never received. + =head2 Field names The API surface is English, but the B<data fields keep the API's own Portuguese @@ -169,7 +182,7 @@ The L<Cepis::Client> behind the functions above, built on first use. =head1 SEE ALSO L<Cepis::Client>, L<Cepis::Address>, L<Cepis::Geo>, L<Cepis::Health>, -L<Cepis::Error> +L<Cepis::Error>, L<Cepis::Faixa> The API itself is documented at L<https://cep.is>. |