alicerce, s.m. — base sobre a qual tudo mais se apoia

Infra básica de API pra quem constrói no Brasil.

IP, CEP, DNS, verificação de email e agendamento de jobs — cinco blocos pequenos que qualquer produto brasileiro acaba precisando, numa API só, com o mesmo formato de resposta.

alicerce (pt-br) — the foundation everything else stands on

Basic API infrastructure for building in Brazil.

IP, CEP (postal code), DNS, email verification and job scheduling — five small blocks almost every Brazilian product ends up needing, behind one API, one response format.

Em desenvolvimento — endpoints e limites podem mudar sem aviso In active development — endpoints and limits may change without notice

O que tem hoje

What's live today

  • IP
    Geolocalização de IP
    IP geolocation
    País, cidade, coordenadas e provedor a partir de um endereço IP. Cinco fontes com fallback automático entre elas.
    Country, city, coordinates and provider from an IP address. Five sources with automatic fallback between them.
    GET /api/v1/ip/{ip} 10.000/dia · 416/hora10,000/day · 416/hour
  • CEP
    Endereço a partir do CEP
    Address from postal code (CEP)
    Logradouro, bairro, cidade e UF a partir de um CEP, direto da base dos Correios.
    Street, neighborhood, city and state from a Brazilian postal code, sourced from the official postal database.
    GET /api/v1/cep/{cep} 10.000/dia · 416/hora10,000/day · 416/hour
  • DNS
    Consulta DNS
    DNS lookup
    Registros A, AAAA, NS, MX, TXT e CNAME, consultados em três fontes ao mesmo tempo, mais checagem contra listas de bloqueio.
    A, AAAA, NS, MX, TXT and CNAME records, queried against three sources at once, plus a blocklist check.
    GET /api/v1/dns/{domain} 10.000/dia · 416/hora10,000/day · 416/hour
  • EMAIL
    Verificação de email
    Email verification
    Sintaxe, registros MX e, opcionalmente, checagem SMTP — pra saber se um email existe antes de mandar algo pra ele.
    Syntax, MX records and an optional SMTP probe — know whether an email actually exists before you send to it.
    GET /api/v1/email/verify 10.000/dia · 416/hora10,000/day · 416/hour
  • CRON
    Jobs agendados
    Scheduled jobs
    Agende tarefas recorrentes que rodam isoladas em containers Docker — sua imagem ou um repositório Git.
    Schedule recurring tasks that run isolated in Docker containers — your own image, or a Git repo.
    POST /api/v1/cron/jobs 10.000/dia · 416/hora por operação10,000/day · 416/hour per operation

Limites por IP, contados por API. 10.000/dia se divide em até 416/hora pra evitar que um pico gaste o dia inteiro de uma vez. Sujeitos a mudar enquanto estivermos em desenvolvimento.

Limits are per IP, counted per API. 10,000/day is capped at 416/hour so a burst can't spend the whole day's budget at once. Subject to change while we're in development.

Como usar

How to use it

1crie uma contacreate an account
2troque usuário/senha por um tokenexchange your credentials for a token
3use o token em cada chamadasend the token on every call
# 1. registrar# 1. register
curl -X POST https://api.alicercelabs.com.br/api/v1/user/register \
  -d '{"username":"voce","email":"voce@exemplo.com","password":"..."}'

# 2. logar (Basic Auth) → recebe um token JWT# 2. log in (Basic Auth) → get a JWT back
curl -u voce:senha https://api.alicercelabs.com.br/api/v1/user/login

# 3. usar o token em qualquer API# 3. use the token against any API
curl https://api.alicercelabs.com.br/api/v1/cep/01310100 \
  -H "Authorization: Bearer <token>"