ViewDNS.info - Your one source for DNS related tools!
ViewDNS.info > API > Documentation >

Chinese Firewall Test API



Documentation Home

TOOLS
Abuse Contact Lookup
ASN Lookup
Chinese Firewall Test
DNS Propagation Checker
DNS Record Lookup
DNS Report
DNSSEC Test
Domain/IP Whois
Free Email Lookup
Get HTTP Headers
Google Pagerank Checker
IP History
IP Location Finder
Iran Firewall Test
Is My Site Down
MAC Address Lookup
Ping
Port Scanner
Reverse DNS Lookup
Reverse IP Lookup
Reverse NS Lookup
Reverse Whois Lookup
Spam Database Lookup
Traceroute
URL/String Decode


Chinese Firewall Test

Checks whether a site is blocked by the Great Firewall of China. This test checks across a number of servers from various locations in mainland China to determine if access to the site provided is possible from behind the Great Firewall of China.

This test checks for symptoms of DNS poisoning, one of the more common methods used by the Chinese government to block access to websites.

Note: Version 2 of this API has now been implemented. Please use the 'v2response' data as the original 'response' data will be removed in the near future (it is currently kept in the response only for compatibility).

URL

http://pro.viewdns.info/chinesefirewall/

Parameters

domain - the domain name to test
output - the output format required ('xml' or 'json')
apikey - your api key

Sample Query - Pass Case

domain: test.com

GET http://pro.viewdns.info/chinesefirewall/?domain=test.com&apikey=yourapikey&output=output_type

XML Response (output=xml)

<?xml version='1.0' encoding='ISO-8859-1'?>
<viewdns>
  <query>
    <tool>chinesefirewall_PRO</tool>
    <domain>test.com</domain>
  </query>
  <expectedresponse>174.36.85.72</expectedresponse>
  <response>
    <detail>
      <server>
        <location>Beijing</location>
        <resultvalue>174.36.85.72</resultvalue>
        <resultstatus>ok</resultstatus>
      </server>
      <server>
        <location>Shenzen</location>
        <resultvalue>174.36.85.72</resultvalue>
        <resultstatus>ok</resultstatus>
      </server>
      <server>
        <location>Inner Mongolia</location>
        <resultvalue>174.36.85.72</resultvalue>
        <resultstatus>ok</resultstatus>
      </server>
      <server>
        <location>Heilongjiang Province</location>
        <resultvalue>174.36.85.72</resultvalue>
        <resultstatus>ok</resultstatus>
      </server>
      <server>
        <location>Yunnan Province</location>
        <resultvalue>174.36.85.72</resultvalue>
        <resultstatus>ok</resultstatus>
      </server>
    </detail>
    <summary>
      <result>visible</result>
      <description>All servers were able to reach your site at the correct IP address.  This means that the hostname itself is accessible from within mainland China.</description>
    </summary>
  </response>
  <v2response>
    <dnsresults>
      <detail>
        <server>
          <location>Beijing</location>
          <resultvalue>174.36.85.72</resultvalue>
          <resultstatus>ok</resultstatus>
        </server>
        <server>
          <location>Shenzen</location>
          <resultvalue>174.36.85.72</resultvalue>
          <resultstatus>ok</resultstatus>
        </server>
        <server>
          <location>Inner Mongolia</location>
          <resultvalue>174.36.85.72</resultvalue>
          <resultstatus>ok</resultstatus>
        </server>
        <server>
          <location>Heilongjiang Province</location>
          <resultvalue>174.36.85.72</resultvalue>
          <resultstatus>ok</resultstatus>
        </server>
        <server>
          <location>Yunnan Province</location>
          <resultvalue>174.36.85.72</resultvalue>
          <resultstatus>ok</resultstatus>
        </server>
      </detail>
      <summary>visible</summary>
      <description>All servers were able to reach your site at the correct IP address.  This means that the hostname itself is accessible from within mainland China.</description>
    </dnsresults>
    <httpresults>
      <detail>HTTP/1.1 200 OK</detail>
      <summary>ok</summary>
      <description>This URL appears to be accessible from mainland China.</description>
    </httpresults>
  </v2response>
</viewdns>

JSON Response (output=json)

{
    "query": {
        "tool": "chinesefirewall_PRO",
        "domain": "test.com"
    },
    "expectedresponse": "174.36.85.72",
    "response": {
        "detail": {
            "server": [
                {
                    "location": "Beijing",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                },
                {
                    "location": "Shenzen",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                },
                {
                    "location": "Inner Mongolia",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                },
                {
                    "location": "Heilongjiang Province",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                },
                {
                    "location": "Yunnan Province",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                }
            ]
        },
        "summary": {
            "result": "visible",
            "description": "All servers were able to reach your site at the correct IP address.  This means that the hostname itself is accessible from within mainland China."
        }
    },
    "v2response": {
        "dnsresults": {
            "server": [
                {
                    "location": "Beijing",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                },
                {
                    "location": "Shenzen",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                },
                {
                    "location": "Inner Mongolia",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                },
                {
                    "location": "Heilongjiang Province",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                },
                {
                    "location": "Yunnan Province",
                    "resultvalue": "174.36.85.72",
                    "resultstatus": "ok"
                }
            ],
            "summary": "visible",
            "description": "All servers were able to reach your site at the correct IP address.  This means that the hostname itself is accessible from within mainland China."
        },
        "httpresults": {
            "detail": "HTTP/1.1 200 OK",
            "summary": "ok",
            "description": "This URL appears to be accessible from mainland China."
        }
    }
}

Sample Query - Fail Case

domain: twitter.com

GET http://pro.viewdns.info/abuselookup/?domain=twitter.com&apikey=yourapikey&output=output_type

XML Response (output=xml)

<?xml version='1.0' encoding='ISO-8859-1'?>
<viewdns>
  <query>
    <tool>chinesefirewall_PRO</tool>
    <domain>twitter.com</domain>
  </query>
  <expectedresponse>199.59.148.82 199.59.150.39 199.59.150.7</expectedresponse>
  <response>
    <detail>
      <server>
        <location>Beijing</location>
        <resultvalue>59.24.3.173</resultvalue>
        <resultstatus>fail</resultstatus>
      </server>
      <server>
        <location>Shenzen</location>
        <resultvalue>37.61.54.158</resultvalue>
        <resultstatus>fail</resultstatus>
      </server>
      <server>
        <location>Inner Mongolia</location>
        <resultvalue>59.24.3.173</resultvalue>
        <resultstatus>fail</resultstatus>
      </server>
      <server>
        <location>Heilongjiang Province</location>
        <resultvalue>59.24.3.173</resultvalue>
        <resultstatus>fail</resultstatus>
      </server>
      <server>
        <location>Yunnan Province</location>
        <resultvalue>93.46.8.89</resultvalue>
        <resultstatus>fail</resultstatus>
      </server>
    </detail>
    <summary>
      <result>not_visible</result>
      <description>No servers were able to reach your site on the correct IP address.  This means that any URL's on this host are most likely NOT accessible from within mainland China.</description>
    </summary>
  </response>
  <v2response>
    <dnsresults>
      <detail>
        <server>
          <location>Beijing</location>
          <resultvalue>59.24.3.173</resultvalue>
          <resultstatus>fail</resultstatus>
        </server>
        <server>
          <location>Shenzen</location>
          <resultvalue>37.61.54.158</resultvalue>
          <resultstatus>fail</resultstatus>
        </server>
        <server>
          <location>Inner Mongolia</location>
          <resultvalue>59.24.3.173</resultvalue>
          <resultstatus>fail</resultstatus>
        </server>
        <server>
          <location>Heilongjiang Province</location>
          <resultvalue>59.24.3.173</resultvalue>
          <resultstatus>fail</resultstatus>
        </server>
        <server>
          <location>Yunnan Province</location>
          <resultvalue>93.46.8.89</resultvalue>
          <resultstatus>fail</resultstatus>
        </server>
      </detail>
      <summary>not_visible</summary>
      <description>No servers were able to reach your site on the correct IP address.  This means that any URL's on this host are most likely NOT accessible from within mainland China.</description>
    </dnsresults>
    <httpresults>
      <detail>Connection timed out.</detail>
      <summary>error</summary>
      <description>This URL appears to be blocked in China.</description>
    </httpresults>
  </v2response>
</viewdns>

JSON Response (output=json)

{
    "query": {
        "tool": "chinesefirewall_PRO",
        "domain": "twitter.com"
    },
    "expectedresponse": "199.59.148.82 199.59.149.230 199.59.150.39",
    "response": {
        "detail": {
            "server": [
                {
                    "location": "Beijing",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                },
                {
                    "location": "Shenzen",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                },
                {
                    "location": "Inner Mongolia",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                },
                {
                    "location": "Heilongjiang Province",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                },
                {
                    "location": "Yunnan Province",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                }
            ]
        },
        "summary": {
            "result": "not_visible",
            "description": "No servers were able to reach your site on the correct IP address.  This means that any URL's on this host are most likely NOT accessible from within mainland China."
        }
    },
    "v2response": {
        "dnsresults": {
            "server": [
                {
                    "location": "Beijing",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                },
                {
                    "location": "Shenzen",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                },
                {
                    "location": "Inner Mongolia",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                },
                {
                    "location": "Heilongjiang Province",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                },
                {
                    "location": "Yunnan Province",
                    "resultvalue": "59.24.3.173",
                    "resultstatus": "fail"
                }
            ],
            "summary": "not_visible",
            "description": "No servers were able to reach your site on the correct IP address.  This means that any URL's on this host are most likely NOT accessible from within mainland China."
        },
        "httpresults": {
            "detail": "Connection timed out.",
            "summary": "error",
            "description": "This URL appears to be blocked in China."
        }
    }
}







All content © 2016 ViewDNS.info
Feedback / Suggestions / Contact Us   Become an Affiliate