CEP-Generator und -Abfrage

Erzeuge eine echte CEP mit Adresse für deine Tests oder finde die Adresse zu einer CEP.

Was möchtest du tun?

Beim Öffnen der Seite wird eine CEP erzeugt. Wähle den Bundesstaat oder klicke auf "CEP erzeugen", um eine neue zu erstellen.

So funktioniert es

  • Die CEPs sind echt und stammen von der brasilianischen Post (Correios), über ViaCEP: Jede existiert und passt zur angezeigten Straße, zum Stadtteil und zur Stadt.
  • Sie werden aus Straßen der Hauptstadt und einer weiteren Großstadt jedes Bundesstaats gewählt und funktionieren daher in Formularen, die die Adresse anhand der CEP ausfüllen.
  • CEPs, die nur Firmen oder Behörden vorbehalten sind, werden ausgelassen.

So nutzt du die API

Du kannst den CEP-Generator über unsere REST-API in deine Anwendung einbinden.

Endpunkt

GET /api/generators/address

Query-Parameter

state
Optional. Das Kürzel des Bundesstaats, z. B. "SP". Ohne Angabe wird der Bundesstaat zufällig gewählt.
formatted
Optional. "false" erzeugt die CEP nur mit Ziffern. Standard: "true".

Beispiel mit curl

curl "https://devtools.vmotta.dev/api/generators/address?state=PE"

Antwort

{
  "address": {
    "cep": "55016-460",
    "street": "Avenida Terezina",
    "neighborhood": "Universitário",
    "city": "Caruaru",
    "state": "PE"
  }
}