API 요청
/rest/whois요청 파라미터 1개 · 필수 1
address- 예시
example.co.kr
응답 필드 9개
datadata.resultdata.successdata.errorapiapi.successapi.costapi.msapi.pl_id특정 도메인 또는 IP의 WHOIS 정보를 조회합니다.
https://apick.app/rest/whois왜 WHOIS 조회인가
도메인 등록 정보를 확인하려고 조회 사이트를 오가며 복사·붙여넣기 하고 있나요? 도메인이나 IP의 WHOIS 정보를 구조화된 응답으로 받아 검증과 관리를 자동화하세요.
도메인·IP 주소·AS번호의 WHOIS 정보(등록인·등록일·만료일·등록대행자·네임서버, IP 할당 기관 등)를 텍스트 원문으로 돌려줍니다. 도메인 만료일 확인, 도메인 소유 확인, IP 할당 기관 확인에 씁니다.
조회에 성공하면 한 건당 100P가 차감됩니다. 실패하면 data.error로 응답하며 과금되지 않습니다.
결과는 구조화된 필드가 아니라 WHOIS 텍스트 한 덩어리입니다. 항목 이름과 순서가 도메인 종류(.kr·.com·.app 등)마다 다르므로, 필요한 값은 줄 단위로 찾아 쓰세요.
/rest/whoisaddressexample.co.krdatadata.resultdata.successdata.errorapiapi.successapi.costapi.msapi.pl_idPOST https://apick.app/rest/whoisAuthorization: Bearer — 내 계정의 API 인증키multipart/form-data상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.
도메인 갱신 시점을 관리할 때 씁니다.
/rest/whoiscurl --fail-with-body --request POST 'https://apick.app/rest/whois' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string 'address=example.co.kr'const form = new FormData();
form.append("address", "example.co.kr");
const response = await fetch("https://apick.app/rest/whois", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
body: form,
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);import os
import requests
parts = [
("address", (None, "example.co.kr")),
]
response = requests.request("POST", "https://apick.app/rest/whois",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'address' => 'example.co.kr',
];
$curl = curl_init('https://apick.app/rest/whois');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $form,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);data.result 텍스트에서 사용 종료일 또는 Expiration Date 줄을 찾아 만료일을 읽습니다..com·.app 같은 도메인도 같은 방식으로 조회합니다.
/rest/whoiscurl --fail-with-body --request POST 'https://apick.app/rest/whois' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string 'address=example.com'const form = new FormData();
form.append("address", "example.com");
const response = await fetch("https://apick.app/rest/whois", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
body: form,
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);import os
import requests
parts = [
("address", (None, "example.com")),
]
response = requests.request("POST", "https://apick.app/rest/whois",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'address' => 'example.com',
];
$curl = curl_init('https://apick.app/rest/whois');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $form,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);Registry Expiry Date·Registrar 같은 줄을 찾아 씁니다.IP 주소를 보내면 그 IP를 할당받은 기관·네트워크 정보를 받습니다.
/rest/whoiscurl --fail-with-body --request POST 'https://apick.app/rest/whois' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string 'address=168.126.63.1'const form = new FormData();
form.append("address", "168.126.63.1");
const response = await fetch("https://apick.app/rest/whois", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
body: form,
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);import os
import requests
parts = [
("address", (None, "168.126.63.1")),
]
response = requests.request("POST", "https://apick.app/rest/whois",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'address' => '168.126.63.1',
];
$curl = curl_init('https://apick.app/rest/whois');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $form,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);IP/Domain 형식이 잘못되었습니다.가 오면 입력 형식을 확인합니다. 과금되지 않습니다.HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
{
"data": {
"result": "> query : example.co.kr\n\n\n# KOREAN(UTF8)\n\n도메인이름 : example.co.kr\n등록인 : 홍길동\n책임자 : 홍길동\n책임자 전자우편 : user@example.com\n등록일 : 2017. 03. 05.\n최근 정보 변경일 : 2025. 04. 30.\n사용 종료일 : 2027. 03. 05.\n등록대행자 : 예시등록대행\n\n1차 네임서버 정보\n 호스트이름 : ns1.example.co.kr\n\n\n# ENGLISH\n\nDomain Name : example.co.kr\nRegistrant : Hong Gildong\nRegistered Date : 2017. 03. 05.\nExpiration Date : 2027. 03. 05.\n",
"success": 1
},
"api": { "success": true, "cost": 100, "ms": 98, "pl_id": 1595643 }
}
만료일을 읽을 때는 .kr 도메인은 사용 종료일 또는 Expiration Date 줄을, 그 밖의 도메인은 Registry Expiry Date·Expiration Date 같은 줄을 찾으세요. 개인정보 보호 설정에 따라 등록인 정보는 가려져 있을 수 있습니다.
\n)으로 구분됩니다. .kr·.한국 도메인과 국내 IP·AS번호는 # KOREAN(UTF8) 구역과 # ENGLISH 구역이 함께 오며, 그 밖의 도메인은 영문 WHOIS 원문 형식입니다.응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.{
"data": {
"error": "입력값을 확인해 주세요.",
"success": 0
},
"api": {
"success": true,
"cost": 0,
"ms": 5
}
}address를 채워 다시 요청합니다.https://·경로를 지우고 철자를 확인합니다. 해외 IPv6·해외 AS번호는 조회하지 않습니다.오류 응답은 모두 api.cost가 0이며 과금되지 않습니다.
FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.