E-Mail-Adressen

Diese Ressource dient allein der Verfügbarkeitsprüfung bzw. Validierung von E-Mail-Adressen, die ONE Sites - respektive dessen Inhabern/Inhaberinnen - als primäre Mailadressen zugewiesen werden (sollen).

Die primären Mailadressen von ONE Sites sind eindeutig. Es ist nicht möglich, mehrere ONE Sites mit der gleichen Adresse anzulegen.

Adresse validieren

Endpunkt
GET https://api.immonex.one/wp-json/one-api/v2/site-email-addresses/:email

Soll eine Mailadresse im Vorfeld der Erstellung einer neuen ONE Site geprüft werden, erfolgt die API-Anfrage ohne Payload:

Request (Beispiel)
GET https://api.immonex.one/wp-json/one-api/v2/site-email-addresses/info@abc-xyz.immo

Vor der Aktualisierung einer existierenden ONE Site wird deren ID als Payload (Request-Body) mit übergeben:

1
2
3

{
	"site_id": 28
}

Response (Erfolg)
200 OK

1
2
3
4
5
6
7

{
    "code": "valid",
    "data": {
        "email": "info@abc-xyz.immo",
        "valid": 1
    }
}

Response (Mailadresse ungültig oder vergeben)
422 Unprocessable Entity

1
2
3
4
5
6
7
8
9

{
    "code": "invalid_or_unavailable_entity",
    "message": "Mailadresse ungültig oder vergeben.",
    "data": {
        "email": "info@abc-xyz.immo",
        "valid": 0,
        "status": 422
    }
}