Itt található egy bővített API kliens verzió, ami tartalmazza az AddressCheck használatához szükséges osztályokat is:
Emellett tartalmaz egy rövid példát is a válasz egy lehetséges feldolgozására.
A legrészletesebb eredményt a lehetséges ellenőrzések közül a Quality Check biztosítja, ezért általában azt szoktuk javasolni (illetve ezt valósítja meg a fenti kód is):
Az éles apihoz tartozó baseURI a következő: https://adc.maileon.com/svc
A demó hozzáférési adatokkal így nézne ki egy példa cURL hívás JSON válasszal:
Kérés:
curl -G -basic -u wiera:KAtAQQxMPP -H'Accept: application/json' https://adc.maileon.com/svc/2.0/address/quality/foo@bar.com
Válasz:
{ "syntax": 1, "extSyntax": 1, "domain": 1, "mailserver": 0, "bounceRisk": 0, "probability": 0, "address": 0, "checked": 0, "decoded": null, "mailserverDiagnosis": 0, "domainScores": [{ "domain": "bt.com", "score": 0.7142857313156128 }, { "domain": "mac.com", "score": 0.7142857313156128 }, { "domain": "mail.com", "score": 0.625 }, { "domain": "yaho.com", "score": 0.625 }] }
A példa PHP kód logikája a következő:
- Ha a válaszban van syntaxWarnings tulajdonság => hibás a cím
- Ha a válaszban van domainScores tulajdonság => nem létezik a domain
- Ha a syntax értéke 0 => hibás a cím
- Ha a domain, a mailserver vagy az address értéke 0 => nem létezik a cím (nincs ilyen domain, nincs rajta mail szerver, vagy van rajta mail szerver de a visszajelzése szerint nem létezik a cím)
- Egyébként létezőként tekintünk a címre