SPF Validator API - Ruby Gem
SPF Validator checks the Sender Policy Framework (SPF) DNS record for a domain to verify if it’s valid and optionally whether a given IP address is authorized to send emails for that domain.
Installation
Add this line to your application's Gemfile:
gem 'apiverve_spfvalidator'
And then execute:
$ bundle install
Or install it yourself as:
$ gem install apiverve_spfvalidator
Getting Started
Get your API key at APIVerve
Basic Usage
require 'apiverve_spfvalidator'
# Initialize the client
client = APIVerve::Spfvalidator::Client.new(api_key: "YOUR_API_KEY")
# Make a request
response = client.execute({ domain: "myspace.com" })
# Print the response
puts response
Error Handling
begin
response = client.execute({ domain: "myspace.com" })
puts response["data"]
rescue APIVerve::Spfvalidator::ValidationError => e
puts "Validation error: #{e.errors.join(', ')}"
rescue APIVerve::Spfvalidator::APIError => e
puts "API error: #{e.}"
puts "Status code: #{e.status_code}"
end
Debug Mode
# Enable debug logging
client = APIVerve::Spfvalidator::Client.new(
api_key: "YOUR_API_KEY",
debug: true
)
Example Response
{
"status": "ok",
"error": null,
"data": {
"host": "myspace.com",
"has_spf_record": true,
"dns_lookups_num": 9,
"spf_record": "v=spf1 mx ip4:63.208.226.34 ip4:204.16.32.0/22 ip4:67.134.143.0/24 ip4:216.205.243.0/24 ip4:34.85.156.5/32 ip4:35.245.108.108/32 ip4:34.86.129.193/32 ip4:34.86.134.94/32 ip4:34.85.222.234/32 ip4:34.86.176.234/32 ip4:34.86.125.212/32 ip4:34.85.224.60/32 ip4:34.86.160.49/32 ip4:35.245.64.166/32 ip4:35.188.226.11/32 ip4:34.86.208.228/32 ip4:34.85.216.144/32 ip4:35.221.22.153/32 ip4:34.86.137.108/32 ip4:34.86.51.35/32 ip4:34.150.221.40/32 ip4:34.85.216.70/32 ip4:34.86.37.191/32 ip4:34.85.214.215/32 ip4:35.236.234.82/32 ip4:34.86.161.241/32 ip4:216.32.181.16 ip4:216.178.32.0/20 ip4:168.235.224.0/24 include:_netblocks.mimecast.com -all",
"spf_records_list": [
{
"origin": "myspace.com",
"record": "v=spf1 mx ip4:63.208.226.34 ip4:204.16.32.0/22 ip4:67.134.143.0/24 ip4:216.205.243.0/24 ip4:34.85.156.5/32 ip4:35.245.108.108/32 ip4:34.86.129.193/32 ip4:34.86.134.94/32 ip4:34.85.222.234/32 ip4:34.86.176.234/32 ip4:34.86.125.212/32 ip4:34.85.224.60/32 ip4:34.86.160.49/32 ip4:35.245.64.166/32 ip4:35.188.226.11/32 ip4:34.86.208.228/32 ip4:34.85.216.144/32 ip4:35.221.22.153/32 ip4:34.86.137.108/32 ip4:34.86.51.35/32 ip4:34.150.221.40/32 ip4:34.85.216.70/32 ip4:34.86.37.191/32 ip4:34.85.214.215/32 ip4:35.236.234.82/32 ip4:34.86.161.241/32 ip4:216.32.181.16 ip4:216.178.32.0/20 ip4:168.235.224.0/24 include:_netblocks.mimecast.com -all",
"chars_num": 637,
"use_macro": false,
"domains": [
"_netblocks.mimecast.com"
],
"authorized_ips": {
"ipv4": [
"63.208.226.34",
"204.16.32.0/22",
"67.134.143.0/24",
"216.205.243.0/24",
"34.85.156.5/32",
"35.245.108.108/32",
"34.86.129.193/32",
"34.86.134.94/32",
"34.85.222.234/32",
"34.86.176.234/32",
"34.86.125.212/32",
"34.85.224.60/32",
"34.86.160.49/32",
"35.245.64.166/32",
"35.188.226.11/32",
"34.86.208.228/32",
"34.85.216.144/32",
"35.221.22.153/32",
"34.86.137.108/32",
"34.86.51.35/32",
"34.150.221.40/32",
"34.85.216.70/32",
"34.86.37.191/32",
"34.85.214.215/32",
"35.236.234.82/32",
"34.86.161.241/32",
"216.32.181.16",
"216.178.32.0/20",
"168.235.224.0/24"
]
}
},
{
"origin": "_netblocks.mimecast.com",
"record": "v=spf1 include:eu._netblocks.mimecast.com include:us._netblocks.mimecast.com include:za._netblocks.mimecast.com include:de._netblocks.mimecast.com include:au._netblocks.mimecast.com include:ca._netblocks.mimecast.com include:usb._netblocks.mimecast.com ~all",
"chars_num": 257,
"use_macro": false,
"domains": [
"eu._netblocks.mimecast.com",
"us._netblocks.mimecast.com",
"za._netblocks.mimecast.com",
"de._netblocks.mimecast.com",
"au._netblocks.mimecast.com",
"ca._netblocks.mimecast.com",
"usb._netblocks.mimecast.com"
]
},
{
"origin": "eu._netblocks.mimecast.com",
"record": "v=spf1 ip4:195.130.217.0/24 ip4:91.220.42.0/24 ip4:146.101.78.0/24 ip4:207.82.80.0/24 ip4:213.167.81.0/25 ip4:193.7.207.0/25 ip4:213.167.75.0/25 ip4:185.58.85.0/24 ip4:185.58.86.0/24 ip4:193.7.206.0/25 ip4:147.28.36.0/24 ~all",
"chars_num": 225,
"use_macro": false,
"authorized_ips": {
"ipv4": [
"195.130.217.0/24",
"91.220.42.0/24",
"146.101.78.0/24",
"207.82.80.0/24",
"213.167.81.0/25",
"193.7.207.0/25",
"213.167.75.0/25",
"185.58.85.0/24",
"185.58.86.0/24",
"193.7.206.0/25",
"147.28.36.0/24"
]
}
},
{
"origin": "us._netblocks.mimecast.com",
"record": "v=spf1 ip4:207.211.31.0/25 ip4:205.139.110.0/24 ip4:216.205.24.0/24 ip4:170.10.129.0/24 ip4:63.128.21.0/24 ip4:170.10.133.0/24 ip4:185.58.84.93/32 ip4:207.211.41.113/32 ip4:207.211.30.64/26 ip4:207.211.30.128/25 ip4:216.145.221.0/24 ip4:170.10.128.0/24 ip4:170.10.132.56/29 ip4:170.10.132.64/29 ~all",
"chars_num": 299,
"use_macro": false,
"authorized_ips": {
"ipv4": [
"207.211.31.0/25",
"205.139.110.0/24",
"216.205.24.0/24",
"170.10.129.0/24",
"63.128.21.0/24",
"170.10.133.0/24",
"185.58.84.93/32",
"207.211.41.113/32",
"207.211.30.64/26",
"207.211.30.128/25",
"216.145.221.0/24",
"170.10.128.0/24",
"170.10.132.56/29",
"170.10.132.64/29"
]
}
},
{
"origin": "za._netblocks.mimecast.com",
"record": "v=spf1 ip4:41.74.192.0/22 ip4:41.74.200.0/23 ip4:41.74.196.0/22 ip4:41.74.204.0/23 ip4:41.74.206.0/24 ~all",
"chars_num": 106,
"use_macro": false,
"authorized_ips": {
"ipv4": [
"41.74.192.0/22",
"41.74.200.0/23",
"41.74.196.0/22",
"41.74.204.0/23",
"41.74.206.0/24"
]
}
},
{
"origin": "de._netblocks.mimecast.com",
"record": "v=spf1 ip4:51.163.158.0/24 ip4:194.104.109.0/24 ip4:194.104.111.0/24 ip4:194.104.110.21/32 ip4:194.104.110.240/28 ip4:62.140.10.21/32 ip4:62.140.7.0/24 ip4:194.104.108.240/29 ip4:194.104.108.21/32 ip4:51.163.159.0/24 ~all",
"chars_num": 221,
"use_macro": false,
"authorized_ips": {
"ipv4": [
"51.163.158.0/24",
"194.104.109.0/24",
"194.104.111.0/24",
"194.104.110.21/32",
"194.104.110.240/28",
"62.140.10.21/32",
"62.140.7.0/24",
"194.104.108.240/29",
"194.104.108.21/32",
"51.163.159.0/24"
]
}
},
{
"origin": "au._netblocks.mimecast.com",
"record": "v=spf1 ip4:103.13.69.0/24 ip4:124.47.150.0/24 ip4:124.47.189.0/24 ip4:103.96.23.0/24 ip4:103.96.21.0/24 ip4:180.189.28.0/24 ip4:216.145.217.0/24 ip4:103.96.22.96/28 ip4:103.96.22.22/32 ip4:103.96.20.22/32 ip4:103.96.20.96/28 ~all",
"chars_num": 229,
"use_macro": false,
"authorized_ips": {
"ipv4": [
"103.13.69.0/24",
"124.47.150.0/24",
"124.47.189.0/24",
"103.96.23.0/24",
"103.96.21.0/24",
"180.189.28.0/24",
"216.145.217.0/24",
"103.96.22.96/28",
"103.96.22.22/32",
"103.96.20.22/32",
"103.96.20.96/28"
]
}
},
{
"origin": "ca._netblocks.mimecast.com",
"record": "v=spf1 ip4:170.10.145.0/24 ip4:170.10.147.0/24 ip4:170.10.144.126/32 ip4:170.10.146.126/32 ip4:170.10.144.240/29 ip4:170.10.146.240/29 ip4:216.145.216.0/24 ~all",
"chars_num": 160,
"use_macro": false,
"authorized_ips": {
"ipv4": [
"170.10.145.0/24",
"170.10.147.0/24",
"170.10.144.126/32",
"170.10.146.126/32",
"170.10.144.240/29",
"170.10.146.240/29",
"216.145.216.0/24"
]
}
},
{
"origin": "usb._netblocks.mimecast.com",
"record": "v=spf1 ip4:170.10.151.0/24 ip4:170.10.153.0/24 ip4:170.10.150.240/29 ip4:170.10.152.240/29 ip4:170.10.156.0/24 ip4:170.10.157.0/24 ~all",
"chars_num": 135,
"use_macro": false,
"authorized_ips": {
"ipv4": [
"170.10.151.0/24",
"170.10.153.0/24",
"170.10.150.240/29",
"170.10.152.240/29",
"170.10.156.0/24",
"170.10.157.0/24"
]
}
}
],
"domains_extracted": [
"myspace.com",
"_netblocks.mimecast.com",
"eu._netblocks.mimecast.com",
"us._netblocks.mimecast.com",
"za._netblocks.mimecast.com",
"de._netblocks.mimecast.com",
"au._netblocks.mimecast.com",
"ca._netblocks.mimecast.com",
"usb._netblocks.mimecast.com"
],
"authorized_ips": {
"ipv4": [
"63.208.226.34",
"204.16.32.0/22",
"67.134.143.0/24",
"216.205.243.0/24",
"34.85.156.5/32",
"35.245.108.108/32",
"34.86.129.193/32",
"34.86.134.94/32",
"34.85.222.234/32",
"34.86.176.234/32",
"34.86.125.212/32",
"34.85.224.60/32",
"34.86.160.49/32",
"35.245.64.166/32",
"35.188.226.11/32",
"34.86.208.228/32",
"34.85.216.144/32",
"35.221.22.153/32",
"34.86.137.108/32",
"34.86.51.35/32",
"34.150.221.40/32",
"34.85.216.70/32",
"34.86.37.191/32",
"34.85.214.215/32",
"35.236.234.82/32",
"34.86.161.241/32",
"216.32.181.16",
"216.178.32.0/20",
"168.235.224.0/24",
"195.130.217.0/24",
"91.220.42.0/24",
"146.101.78.0/24",
"207.82.80.0/24",
"213.167.81.0/25",
"193.7.207.0/25",
"213.167.75.0/25",
"185.58.85.0/24",
"185.58.86.0/24",
"193.7.206.0/25",
"147.28.36.0/24",
"207.211.31.0/25",
"205.139.110.0/24",
"216.205.24.0/24",
"170.10.129.0/24",
"63.128.21.0/24",
"170.10.133.0/24",
"185.58.84.93/32",
"207.211.41.113/32",
"207.211.30.64/26",
"207.211.30.128/25",
"216.145.221.0/24",
"170.10.128.0/24",
"170.10.132.56/29",
"170.10.132.64/29",
"41.74.192.0/22",
"41.74.200.0/23",
"41.74.196.0/22",
"41.74.204.0/23",
"41.74.206.0/24",
"51.163.158.0/24",
"194.104.109.0/24",
"194.104.111.0/24",
"194.104.110.21/32",
"194.104.110.240/28",
"62.140.10.21/32",
"62.140.7.0/24",
"194.104.108.240/29",
"194.104.108.21/32",
"51.163.159.0/24",
"103.13.69.0/24",
"124.47.150.0/24",
"124.47.189.0/24",
"103.96.23.0/24",
"103.96.21.0/24",
"180.189.28.0/24",
"216.145.217.0/24",
"103.96.22.96/28",
"103.96.22.22/32",
"103.96.20.22/32",
"103.96.20.96/28",
"170.10.145.0/24",
"170.10.147.0/24",
"170.10.144.126/32",
"170.10.146.126/32",
"170.10.144.240/29",
"170.10.146.240/29",
"216.145.216.0/24",
"170.10.151.0/24",
"170.10.153.0/24",
"170.10.150.240/29",
"170.10.152.240/29",
"170.10.156.0/24",
"170.10.157.0/24"
],
"ipv6": []
},
"issues_found": [],
"spf_valid": true,
"has_issues": false,
"macros_found": false,
"ip_pass": false,
"elapsed_ms": 431,
"all_qualifier": "fail",
"risk_score": 5,
"risk_level": "low"
}
}
Documentation
For more information, visit the API Documentation.
Support
- Website: https://spfvalidator.apiverve.com?utm_source=ruby&utm_medium=readme
- Email: hello@apiverve.com
License
This gem is available under the MIT License.