Regelbasierte US-Adressvalidierung für Formular- und Negativtests: Standardisierung im USPS-Stil, ZIP-Format- und ZIP-zu-Bundesstaat-Prüfungen, eine Beispiel-ZIP-Abfrage und 422-Fehler pro Feld.
Basis-URL: https://funapi.dev/api/address/v1 · 3 Endpunkte · OpenAPI-3.1-Spezifikation und Postman-Collection verfügbar. Neu hier? Lesen Sie die Einstiegsanleitung.
validieren und standardisieren
POST /address/v1/validate — Eine US-Adresse validieren und standardisieren (USPS-Abkürzungen, ZIP/Bundesstaat-Prüfung) · Antwortet mit 200 422 Link zu diesem EndpunktZIPs und Bundesstaaten
GET /address/v1/zip/{zip} — Stadt und Bundesstaat für eine ZIP aus dem Beispielsatz · Antwortet mit 200 400 404 Link zu diesem EndpunktGET /address/v1/states — Die 50 Bundesstaaten und DC mit ihren Codes · Antwortet mit 200 Link zu diesem EndpunktDie US Address Validation API prüft Adressen so, wie ein Checkout-Formular es braucht: Sie standardisiert die Straßenzeile mit USPS-Abkürzungen, normalisiert Stadt, Bundesstaat und ZIP+4, markiert eine ZIP, deren USPS-Gebiet den Bundesstaat nicht enthält, und liefert 422-Fehler pro Feld für fehlende oder fehlerhafte Eingaben. Es ist eine regelbasierte Übungsvalidierung, kein USPS-Dienst, was sie deterministisch und kostenlos hält.
GET https://funapi.dev/api/address/v1/states — Die 50 Bundesstaaten und DC mit ihren Codes. Kein Token, keine Anmeldung:
curl -i https://funapi.dev/api/address/v1/states
Antwort: 200 OK
{
"data": [
{
"code": "AL",
"name": "Alabama"
},
{
"code": "AK",
"name": "Alaska"
},
{
"code": "AZ",
"name": "Arizona"
},
{
"code": "AR",
"name": "Arkansas"
},
{
"code": "CA",
"name": "California"
},
{
"code": "CO",
"name": "Colorado"
},
{
"code": "CT",
"name": "Connecticut"
},
{
"code": "DE",
"name": "Delaware"
},
{
"code": "DC",
"name": "District of Columbia"
},
{
"code": "FL",
"name": "Florida"
},
{
"code": "GA",
"name": "Georgia"
},
{
"code": "HI",
"name": "Hawaii"
},
{
"code": "ID",
"name": "Idaho"
},
{
"code": "IL",
"name": "Illinois"
},
{
"code": "IN",
"name": "Indiana"
},
{
"code": "IA",
"name": "Iowa"
},
{
"code": "KS",
"name": "Kansas"
},
{
"code": "KY",
"name": "Kentucky"
},
{
"code": "LA",
(gekürzt – die vollständige Antwort erhalten Sie nach Ausführung des Skripts)
Diesen Endpunkt öffnen und ausführen
Zuletzt aktualisiert