API 문서

RESTful API에 액세스하여 IPv6 네트워크 진단 도구를 애플리케이션에 통합하세요. 모든 엔드포인트는 JSON 응답을 반환하며 IPv4와 IPv6를 모두 지원합니다.

기본 URL

Bash

https://ping6.net/api/v1

HTTPS 전용

모든 API 요청은 보안 통신을 위해 HTTPS를 사용해야 합니다.

CORS 활성화

모든 도메인에서의 교차 출처 요청이 지원됩니다.

인증

대부분의 엔드포인트는 인증 없이 사용할 수 있습니다. 더 높은 요청 제한과 프리미엄 기능에 액세스하려면 API 키를 사용하세요.

익명

인증이 필요 없습니다. 더 낮은 요청 제한이 적용됩니다.

API 키

더 높은 요청 제한을 위해 X-API-Key 헤더에 API 키를 포함하세요.

Bash

curl -X GET "https://ping6.net/api/v1/ping/google.com" \
  -H "X-API-Key: your-api-key-here"

요청 제한

API 요청은 공정한 사용과 서비스 가용성을 보장하기 위해 요청 제한이 적용됩니다.

등급	요청	비고
익명	100 / minute	IP 기반 제한. 동일 IP의 모든 익명 사용자가 공유합니다.
API 키	1,000 / minute	API 키당. 더 높은 제한이 필요하면 문의하세요.

요청 제한 헤더

X-RateLimit-Limit창당 허용되는 최대 요청 수

X-RateLimit-Remaining현재 창의 남은 요청 수

X-RateLimit-Reset요청 제한이 재설정되는 Unix 타임스탬프

오류 처리

API는 성공 또는 실패를 나타내기 위해 표준 HTTP 응답 코드를 사용합니다.

코드	상태	설명
400	Bad Request	잘못된 요청 매개변수 또는 형식이 잘못된 요청 본문.
401	Unauthorized	보호된 엔드포인트에 대한 잘못되거나 누락된 API 키.
404	Not Found	요청된 리소스 또는 엔드포인트가 존재하지 않습니다.
429	Too Many Requests	요청 제한 초과. 더 많은 요청을 하기 전에 기다리세요.
500	Internal Server Error	서버 오류. 나중에 다시 시도하거나 지원팀에 문의하세요.

JSON

{
  "error": {
    "code": "INVALID_ADDRESS",
    "message": "The provided address is not a valid IPv6 address",
    "details": {
      "address": "invalid-address"
    }
  }
}

API 엔드포인트

GET/myip

내 IP 주소 가져오기

요청을 하는 클라이언트의 공용 IP 주소를 반환합니다. 연결이 IPv4인지 IPv6인지 자동으로 감지합니다.

Example Response

JSON

{
  "ip": "2001:db8:85a3::8a2e:370:7334",
  "version": 6,
  "isIPv6": true
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/myip" \
  -H "Accept: application/json"

GET/validate

IPv6 주소 검증

IPv6 주소를 검증하고 형식, 유형 및 정규 표현에 대한 상세 정보를 반환합니다.

Parameters

Name	Type	In	Description
`address`*	string	query	검증할 IPv6 주소

Example Response

JSON

{
  "valid": true,
  "type": "Documentation",
  "compressed": "2001:db8::1",
  "expanded": "2001:0db8:0000:0000:0000:0000:0000:0001"
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/validate?address=2001:db8::1" \
  -H "Accept: application/json"

GET/dns/{hostname}

DNS 조회

구성 가능한 DNS 리졸버를 사용하여 호스트명의 DNS 레코드를 쿼리합니다. IPv6용 AAAA 레코드에 특별히 중점을 두고 모든 일반 레코드 유형을 지원합니다.

Parameters

Name	Type	In	Description
`hostname`*	string	path	쿼리할 호스트명
`type`	enum: AAAA \| A \| MX \| TXT \| NS \| CNAME \| SOA \| PTR	query	쿼리할 DNS 레코드 유형(default: `AAAA`)
`resolver`	enum: cloudflare \| google \| quad9	query	쿼리에 사용할 DNS 리졸버(default: `cloudflare`)

Example Response

JSON

{
  "hostname": "google.com",
  "records": [
    {
      "type": "AAAA",
      "value": "2607:f8b0:4004:800::200e",
      "ttl": 300
    }
  ],
  "resolver": "cloudflare",
  "queryTime": 23
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/dns/google.com?type=AAAA&resolver=cloudflare" \
  -H "Accept: application/json"

GET/ping/{target}Beta

대상 Ping

IPv6 주소 또는 호스트명에 ICMP 에코 요청을 보내고 지연 통계를 받습니다. API 키 인증이 필요합니다.

Parameters

Name	Type	In	Description
`target`*	string	path	ping할 IPv6 주소 또는 호스트명
`count`	string	query	보낼 ping 패킷 수 (1-10)(default: `4`)

Example Response

JSON

{
  "target": "2001:4860:4860::8888",
  "ip": "2001:4860:4860::8888",
  "results": [
    {
      "seq": 1,
      "ttl": 117,
      "rtt": 12.4
    },
    {
      "seq": 2,
      "ttl": 117,
      "rtt": 11.8
    },
    {
      "seq": 3,
      "ttl": 117,
      "rtt": 12.1
    },
    {
      "seq": 4,
      "ttl": 117,
      "rtt": 11.9
    }
  ],
  "stats": {
    "transmitted": 4,
    "received": 4,
    "loss": 0,
    "min": 11.8,
    "avg": 12.05,
    "max": 12.4
  }
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/ping/2001:4860:4860::8888?count=4" \
  -H "Accept: application/json" \
  -H "X-API-Key: your-api-key"

GET/traceroute/{target}Beta

Traceroute

목적지까지의 네트워크 경로를 추적하여 경로의 각 홉에 대한 지연 정보를 보여줍니다. API 키 인증이 필요합니다.

Parameters

Name	Type	In	Description
`target`*	string	path	추적할 IPv6 주소 또는 호스트명
`maxHops`	string	query	추적할 최대 홉 수 (1-64)(default: `30`)

Example Response

JSON

{
  "target": "google.com",
  "ip": "2607:f8b0:4004:800::200e",
  "hops": [
    {
      "hop": 1,
      "ip": "2001:db8::1",
      "hostname": "router.local",
      "rtt": 1.2
    },
    {
      "hop": 2,
      "ip": "2001:db8:1::1",
      "hostname": "isp-gateway.net",
      "rtt": 5.4
    },
    {
      "hop": 3,
      "ip": "2607:f8b0:4004:800::200e",
      "hostname": "google.com",
      "rtt": 12.8
    }
  ]
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/traceroute/google.com?maxHops=30" \
  -H "Accept: application/json" \
  -H "X-API-Key: your-api-key"