# WHOIS 조회
특정 도메인 또는 IP의 WHOIS 정보를 조회합니다.
인증: Authorization: Bearer $APICK_API_KEY
본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다.
인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다.
## POST /rest/whois 응답 필드
- `data` (object): 조회 데이터
- `data.result` (string): WHOIS 조회 결과
- `data.success` (integer): 과금 여부0: 실패1: 성공3: 실패(timeout)
- `api` (object): API 호출 공통 데이터
- `api.success` (boolean): API 서버 정상 응답 여부
- `api.cost` (integer): API 호출 요금
- `api.pl_id` (integer): API 결제 로그 ID
- `api.ms` (integer): API 응답 시간
## API 요청: POST /rest/whois
### 입력
- `address` (string, 필수): 검색할 도메인 또는 IP (예: apick.app)
### 응답 명세
```json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"result": {
"type": "string",
"description": "WHOIS 조회 결과"
},
"success": {
"type": "integer",
"description": "과금 여부0: 실패1: 성공3: 실패(timeout)"
}
},
"description": "조회 데이터"
},
"api": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"description": "API 서버 정상 응답 여부"
},
"cost": {
"type": "integer",
"description": "API 호출 요금"
},
"pl_id": {
"type": "integer",
"description": "API 결제 로그 ID"
},
"ms": {
"type": "integer",
"description": "API 응답 시간"
}
},
"description": "API 호출 공통 데이터"
}
}
}
```
### 정적 응답 예시
```json
{
"data": {
"result": ">query : apick.app\n\n\n# KOREAN(UTF8)\n\n도메인이름 : apick.app\n등록인 : 홍길동\n책임자 : 김찬우\n책임자 전자우편 : helloworld@apick.app\n등록일 : 2017. 03. 05.\n최근 정보 변경일 : 2019. 04. 30.\n사용 종료일 : 2026. 03. 05.\n정보공개여부 : N\n등록대행자 : (주)가비아\nDNSSEC : 미서명\n\n1차 네임서버 정보\n 호스트이름 : ns.gabia.co.kr\n IP 주소 : 43.201.170.100\n\n2차 네임서버 정보\n 호스트이름 : ns1.gabia.co.kr\n IP 주소 : 20.200.205.248\n 호스트이름 : ns.gabia.net\n\n네임서버 이름이 .kr이 아닌 경우는 IP주소가 보이지 않습니다.\n\n\n# ENGLISH\n\nDomain Name : apick.app\nRegistrant : hong gildong\nAdministrative Contact(AC) : hong gildong\nAC E-Mail : helloworld@apick.app\nRegistered Date : 2017. 03. 05.\nLast Updated Date : 2019. 04. 30.\nExpiration Date : 2026. 03. 05.\nPublishes : N\nAuthorized Agency : Gabia, Inc.\nDNSSEC : unsigned\n\nPrimary Name Server\n Host Name : ns.gabia.co.kr\n IP Address : 43.201.170.100\n\nSecondary Name Server\n Host Name : ns1.gabia.co.kr\n IP Address : 20.200.205.248\n Host Name : ns.gabia.net\n\n\n- KISA/KRNIC WHOIS Service -\n\n",
"success": 1
},
"api": {
"success": true,
"cost": 100,
"pl_id": 61,
"ms": 98
}
}
```
### curl
```curl
curl --fail-with-body --request POST 'https://apick.app/rest/whois' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string 'address=apick.app'
```
### Node.js (서버 ESM)
```javascript
const form = new FormData();
form.append("address", "apick.app");
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);
```
### python
```python
import os
import requests
parts = [
("address", (None, "apick.app")),
]
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
```php
'apick.app',
];
$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);
```
## 코드·오류
## 상세 기능·요금
Method URL POST https://apick.app/rest/whois API 호출 요청 요청하기 Key Value address 응답
## 상세 요청
Header 이름 필수 설명 Authorization O Bearer 인증키
## 상세 응답
Body 이름 타입 설명 data Object 조회 데이터 result String WHOIS 조회 결과 success Integer 과금 여부0: 실패1: 성공3: 실패(timeout) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID
## 상세 예제
요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "result": ">query : apick.app\n\n\n# KOREAN(UTF8)\n\n도메인이름 : apick.app\n등록인 : 홍길동\n책임자 : 김찬우\n책임자 전자우편 : helloworld@apick.app\n등록일 : 2017. 03. 05.\n최근 정보 변경일 : 2019. 04. 30.\n사용 종료일 : 2026. 03. 05.\n정보공개여부 : N\n등록대행자 : (주)가비아\nDNSSEC : 미서명\n\n1차 네임서버 정보\n 호스트이름 : ns.gabia.co.kr\n IP 주소 : 43.201.170.100\n\n2차 네임서버 정보\n 호스트이름 : ns1.gabia.co.kr\n IP 주소 : 20.200.205.248\n 호스트이름 : ns.gabia.net\n\n네임서버 이름이 .kr이 아닌 경우는 IP주소가 보이지 않습니다.\n\n\n# ENGLISH\n\nDomain Name : apick.app\nRegistrant : hong gildong\nAdministrative Contact(AC) : hong gildong\nAC E-Mail : helloworld@apick.app\nRegistered Date : 2017. 03. 05.\nLast Updated Date : 2019. 04. 30.\nExpiration Date : 2026. 03. 05.\nPublishes : N\nAuthorized Agency : Gabia, Inc.\nDNSSEC : unsigned\n\nPrimary Name Server\n Host Name : ns.gabia.co.kr\n IP Address : 43.201.170.100\n\nSecondary Name Server\n Host Name : ns1.gabia.co.kr\n IP Address : 20.200.205.248\n Host Name : ns.gabia.net\n\n\n- KISA/KRNIC WHOIS Service -\n\n", "success": 1 }, "api": { "success": true, "cost": 100, "pl_id": 61, "ms": 98 } }