Selamat datang di Page Documentation !. Ini merupakan dokumentasi untuk pengguna layanan api, WhoisTools menyediakan beberapa jenis API yaitu Whois API, Whois Raw, & User Agent IP.

Untuk Menggunakan service kami, anda diharuskan untuk mendaftar dengan kami, setelah mendaftar anda akan mendapatkan API Key untuk Authentication pada Server API kami.

Stable base URL Endpoints is : https://api.whoistools.web.id/v1/

Untuk pengaplikasian API, anda dapat menggunakan cURL yang bisa anda sesuaikan dengan bahasa pemograman anda. Anda juga disarankan menggunakan PHP Library WhoisTools yang bisa di download di Github.

WhoisTools Menggunakan Sistem RestFull API dengan result JSON. Untuk Authentikasi akun, bisa dengan API Key yang dapat anda lihat di dashboard Utama. Percobaan pertama yang anda dapat lakukan ialah sebagai berikut:

cURL (example) :

curl -X GET "https://api.whoistools.web.id/v1/user/:api_key"

PHP Library (example):

<?php
require_once 'whoistools.class.php';

/*** Loading Class ***/
$whois = new WhoisTools(':api_key');
$results = $whois->UserInfo();

echo "<pre>"; print_r($results); echo "</pre>";
?>
                                    


Parameters Desciption
Parameters Desciption
:api_key API Key User

Result JSON Jika Permintaan Sukses :

{
    "success": true,
    "status": "200 OK",
    "result": {
        "username": "jhondoe",
        "name": "Jhon Doe",
        "api_key": "2d4d028de3015345da9420df5514dad0",
        "subscription_type": "basic",
        "apiwhois_usage" : "0",
        "limit_apiwhois" : "50",
        }
}
                                    

Berikut Ini Table Beberapa Respon Code:

Status Description
Status Description
400 Bad Request Invalid Parameters
401 Unauthorized Access Denied To Acces API
405 Method Not Allowed Your Request Method is Not Accept
200 OK Response API Successfully

Berikut Ini merupakan informasi tentang penggunaan Whois API. Untuk Request Header menggunakan GET. Atau, jika anda ingin menggunakan PHP Library dari WhoisTools, anda bisa melihat dari Github

GET whois/:api_key/:domain_name

Parameters Desciption
Parameters Desciption
:api_key API Key User
:domain_name Domain Name yang akan dicari

cURL (example) :

curl -X GET "https://api.whoistools.web.id/v1/whois/:api_key/:domain_name"

PHP Library (example):

<?php
require_once 'whoistools.class.php';
/*** Loading Class ***/
$whois = new WhoisTools('YOU_API_KEY_HERE');
$results = $whois->WhoisAPI('google.com');
echo "<pre>"; print_r($results); echo "</pre>";
?>

Maka Respons yang akan muncul jika sukses :

{
    "copyright_message": "Powered By WhoisTools",
    "success": true,
    "status": "200 OK",
    "result": {
        "domain": "mexious.com",
        "popularity": {
            "rank": "3844803",
            "visitors": "200",
            "comment": "less than 200 visitors per day"
        },
        "ipv4_address": "172.217.7.147",
        "ipv6_address": "2607:f8b0:4006:813::2013",
        "owner": {
            "range_ip": "172.217.0.0 - 172.217.255.255",
            "cidr": "172.217.0.0\/16",
            "ownerName": "Google Inc",
            "ownerAddress": "1600 Amphitheatre Parkway, Mountain View, CA, 94043, US",
            "countryID": "USA",
            "countryName": "USA"
        },
        "reverse_dns": {
            "host": "iad30s07-in-f243.1e100.net",
            "topHost": {
                "topHostName": "1e100.net",
                "ip_address": "",
                "countryID": "",
                "countryName": "",
                "sites": "4218096",
                "text": "4,218,096 sites use XXX.1e100.net as IP Reverse DNS"
            }
        },
        "dns": [
            {
                "nameserver": "nelly.ns.cloudflare.com",
                "ip_address": "173.245.58.209",
                "countryID": "USA",
                "countryName": "USA",
                "countryIcon": "https:\/\/myip.ms\/images\/devices\/16\/flags\/USA.png",
                "sites": "2868",
                "topSites": "83"
            },
            {
                "nameserver": "drew.ns.cloudflare.com",
                "ip_address": "173.245.59.160",
                "countryID": "USA",
                "countryName": "USA",
                "countryIcon": "https:\/\/myip.ms\/images\/devices\/16\/flags\/USA.png",
                "sites": "3247",
                "topSites": "92"
            }
        ],
        "ip_changed_history": [
            {
                "ip_address": "172.217.8.19",
                "host": "iad23s59-in-f19.1e100.net",
                "date_when_website_was_using_ip": "21 Dec 2018",
                "date_when_found_that_website_changed_ip": "25 Jan 2019"
            },
            {
                "ip_address": "172.217.6.243",
                "host": "lga25s55-in-f19.1e100.net",
                "date_when_website_was_using_ip": "21 Nov 2018",
                "date_when_found_that_website_changed_ip": "21 Dec 2018"
            }
        ],
        "raw_whois": {
            "domain": "mexious.com",
            "id": "2277095341_DOMAIN_COM-VRSN",
            "whois_server": [
                "whois.resellercamp.com"
            ],
            "registrar_url": [
                "http:\/\/www.resellercamp.com"
            ],
            "updated": [
                "2018-06-20T03:31:05Z"
            ],
            "created": [
                "2018-06-20T03:30:52Z"
            ],
            "expires": [
                "2019-06-20T03:30:52Z"
            ],
            "registrar": [
                "CV. JOGJACAMP"
            ],
            "status": [
                "clientTransferProhibited https:\/\/icann.org\/epp#clientTransferProhibited"
            ],
            "dns": [
                "DREW.NS.CLOUDFLARE.COM",
                "NELLY.NS.CLOUDFLARE.COM"
            ],
            "created_parsed": {
                "year": 2018,
                "month": 6,
                "day": 20,
                "hour": 3,
                "minute": 30,
                "second": 52,
                "fraction": 0,
                "warning_count": 0,
                "warnings": [],
                "error_count": 0,
                "errors": [],
                "is_localtime": true,
                "zone_type": 2,
                "zone": 0,
                "is_dst": false,
                "tz_abbr": "Z"
            },
            "created_parsed_string": "2018-06-20 03:30:52",
            "expires_parsed": {
                "year": 2019,
                "month": 6,
                "day": 20,
                "hour": 3,
                "minute": 30,
                "second": 52,
                "fraction": 0,
                "warning_count": 0,
                "warnings": [],
                "error_count": 0,
                "errors": [],
                "is_localtime": true,
                "zone_type": 2,
                "zone": 0,
                "is_dst": false,
                "tz_abbr": "Z"
            },
            "expires_parsed_string": "2019-06-20 03:30:52",
            "updated_parsed": {
                "year": 2018,
                "month": 6,
                "day": 20,
                "hour": 3,
                "minute": 31,
                "second": 5,
                "fraction": 0,
                "warning_count": 0,
                "warnings": [],
                "error_count": 0,
                "errors": [],
                "is_localtime": true,
                "zone_type": 2,
                "zone": 0,
                "is_dst": false,
                "tz_abbr": "Z"
            },
            "updated_parsed_string": "2018-06-20 03:31:05"
        }
    }
}
                                
                            

Berikut ini merupakan dokumentasi untuk penggunaan Whois Raw. Whois Raw akan menampilkan RAW Result Whois domain yang akan dicari. Raw ini diambil dari data Server Register, Jadi 100% data akurat & Auth tidak diperlukan pada service ini. Berikut ini tata cara penggunaannya :

Untuk menampilkan Querinya, URL Base nya ialah :

GET /raw/:option/:domain_name

Parameters Desciption
Parameters Desciption
:option Pilihan yang dapat dilakukan, Value : download or show. Jika value download, maka raw akan terdownload secara otomatis & jika value show, maka hanya akan memunculkan result saja.
:domain_name Domain Name yang akan dicari

cURL (example) :

curl -X GET "https://api.whoistools.web.id/v1/raw/show/mexious.com"

PHP Library (example):

<?php
require_once 'whoistools.class.php';
/*** Loading Class ***/
$whois = new WhoisTools();
$results = $whois->WhoisRaw('google.com');
echo "<pre>" .$results ."</pre>";
?>
                             

Result Jika Berhasil :

mexious.com domain lookup results from whois.verisign-grs.com server:

Domain Name: MEXIOUS.COM
Registry Domain ID: 2277095341_DOMAIN_COM-VRSN
Registrar WHOIS Server: whois.resellercamp.com
Registrar URL: http://www.resellercamp.com
Updated Date: 2018-06-20T03:31:05Z
Creation Date: 2018-06-20T03:30:52Z
Registry Expiry Date: 2019-06-20T03:30:52Z
Registrar: CV. JOGJACAMP
Registrar IANA ID: 1478
Registrar Abuse Contact Email: abuse@resellercamp.com
Registrar Abuse Contact Phone: +62 274 415 585
Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited
Name Server: DREW.NS.CLOUDFLARE.COM
Name Server: NELLY.NS.CLOUDFLARE.COM
DNSSEC: unsigned
URL of the ICANN Whois Inaccuracy Complaint Form: https://www.icann.org/wicf/
>>> Last update of whois database: 2019-03-16T01:35:00Z <<<
For more information on Whois status codes, please visit https://icann.org/epp
NOTICE: The expiration date displayed in this record is the date the
registrar's sponsorship of the domain name registration in the registry is
currently set to expire. This date does not necessarily reflect the expiration
date of the domain name registrant's agreement with the sponsoring
registrar.  Users may consult the sponsoring registrar's Whois database to
view the registrar's reported date of expiration for this registration.
TERMS OF USE: You are not authorized to access or query our Whois
database through the use of electronic processes that are high-volume and
automated except as reasonably necessary to register domain names or
modify existing registrations; the Data in VeriSign Global Registry
Services' ("VeriSign") Whois database is provided by VeriSign for
information purposes only, and to assist persons in obtaining information
about or related to a domain name registration record. VeriSign does not
guarantee its accuracy. By submitting a Whois query, you agree to abide
by the following terms of use: You agree that you may use this Data only
for lawful purposes and that under no circumstances will you use this Data
to: (1) allow, enable, or otherwise support the transmission of mass
unsolicited, commercial advertising or solicitations via e-mail, telephone,
or facsimile; or (2) enable high volume, automated, electronic processes
that apply to VeriSign (or its computer systems). The compilation,
repackaging, dissemination or other use of this Data is expressly
prohibited without the prior written consent of VeriSign. You agree not to
use electronic processes that are automated and high-volume to access or
query the Whois database except as reasonably necessary to register
domain names or modify existing registrations. VeriSign reserves the right
to restrict your access to the Whois database in its sole discretion to ensure
operational stability.  VeriSign may restrict or terminate your access to the
Whois database for failure to abide by these terms of use. VeriSign
reserves the right to modify these terms at any time.
The Registry database contains ONLY .COM, .NET, .EDU domains and
Registrars.

Respon Jika Error :

Invalid Option Paramaters

Untuk saat ini, layanan user agent ip masih dalam tahap pengembangan, hubungi lebih lanjut di care@mexious.com

Made With By Mexious Media