API 요청
/rest/nslookup요청 파라미터 1개 · 필수 1
domain- 예시
apick.app
응답 필드 9개
datadata.resultdata.successdata.errorapiapi.successapi.costapi.msapi.pl_id특정 도메인에 현재 등록된 IP 주소 목록을 조회합니다.
https://apick.app/rest/nslookup왜 도메인으로 IP 조회인가
DNS를 바꿨는데 반영됐는지, 의심 도메인이 어디로 연결되는지 매번 터미널을 열고 있나요? 도메인을 넣으면 현재 등록된 IP 목록을 바로 돌려줍니다.
도메인 하나를 보내면 지금 그 도메인에 연결된 IPv4 주소 목록을 돌려줍니다. 서버 이전 확인, 접속 대상 IP 확인, 다른 도메인·IP API에 넘길 IP를 얻을 때 씁니다.
조회에 성공하면 한 건당 1P가 차감됩니다. 실제 차감액은 응답의 api.cost에서 확인하세요.
도메인이 비었거나 형식이 맞지 않으면 data.error로 응답하며 과금되지 않습니다.
/rest/nslookupdomainapick.appdatadata.resultdata.successdata.errorapiapi.successapi.costapi.msapi.pl_idPOST https://apick.app/rest/nslookupAuthorization: Bearer — 내 계정의 API 인증키multipart/form-data상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.
서버 이전 뒤 도메인이 새 IP를 가리키는지 확인합니다.
/rest/nslookupcurl --fail-with-body --request POST 'https://apick.app/rest/nslookup' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string 'domain=apick.app'const form = new FormData();
form.append("domain", "apick.app");
const response = await fetch("https://apick.app/rest/nslookup", {
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 = [
("domain", (None, "apick.app")),
]
response = requests.request("POST", "https://apick.app/rest/nslookup",
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 = [
'domain' => 'apick.app',
];
$curl = curl_init('https://apick.app/rest/nslookup');
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[]에 IPv4 주소 목록이 옵니다. 여러 개면 여러 서버를 쓰는 도메인입니다.www·api 같은 하위 도메인도 그대로 보냅니다. https://와 경로는 빼야 합니다.
/rest/nslookupcurl --fail-with-body --request POST 'https://apick.app/rest/nslookup' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string 'domain=www.example.com'const form = new FormData();
form.append("domain", "www.example.com");
const response = await fetch("https://apick.app/rest/nslookup", {
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 = [
("domain", (None, "www.example.com")),
]
response = requests.request("POST", "https://apick.app/rest/nslookup",
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 = [
'domain' => 'www.example.com',
];
$curl = curl_init('https://apick.app/rest/nslookup');
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);Domain 형식이 잘못되었습니다.가 오면 https://·경로·포트가 섞였는지 확인합니다. 과금되지 않습니다.HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
{
"data": {
"result": ["203.0.113.10"],
"success": 1
},
"api": { "success": true, "cost": 1, "ms": 63, "pl_id": 1595635 }
}
받은 IP로 위치를 보려면 도메인/IP 위치 조회, 같은 IP를 쓰는 다른 도메인을 보려면 IP로 도메인 조회에 result[0]을 넘기면 됩니다.
응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
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
}
}domain을 채워 다시 요청합니다.https://·경로를 지우고 철자를 확인합니다.오류 응답은 모두 api.cost가 0이며 과금되지 않습니다.
FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.
같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다.