API 문서

계정이나 API 키 없이 엔드포인트를 살펴보고 요청 예제를 복사하거나 API를 사용해 보세요. 요청을 보내면 입력 데이터가 API로 전송됩니다. 공인 IP 조회는 브라우저 연결을 기준으로 합니다.

대화형 참조 문서와 명세는 영어로 제공됩니다.

POST /v1/cidr-cover

IPv4 또는 IPv6 주소와 CIDR 범위를 JSON으로 보내세요. 응답에는 최소 포괄 CIDR, 정규화된 입력, 10진수 문자열로 표현된 정확한 주소 수가 포함됩니다. 이 API 요청은 입력을 서버로 전송합니다.

curl -fsS https://api.dev.packetrove.com/v1/cidr-cover \
  -H 'Content-Type: application/json' \
  -d '{"inputs":["203.0.113.1","203.0.113.2","203.0.113.6"]}'

이 예제는 203.0.113.0/29을 반환하며 주소 5개를 추가로 포함합니다. 허용 목록이나 차단 목록에 결과를 사용하기 전에 additionalAddressCount를 확인하세요.

POST /v1/cidr-subtract

include에서 exclude를 정확히 뺍니다. 최소 정규 CIDR 목록과 정확한 십진 문자열 주소 수를 반환합니다. 이 API는 입력을 서버로 보냅니다.

curl -fsS https://api.dev.packetrove.com/v1/cidr-subtract \
  -H 'Content-Type: application/json' \
  -d '{"include":["203.0.113.0/24"],"exclude":["203.0.113.64/26"]}'

이 예시는 203.0.113.0/26, 203.0.113.128/25를 반환하며 192개의 주소가 남습니다. 추가 범위는 포함하지 않습니다.

POST /v1/range-to-cidrs

같은 주소 체계의 start와 end를 제출합니다. 양 끝을 포함하며 정규화된 끝점, 최소의 정확한 CIDR 목록, CIDR 수, 십진 문자열 주소 수를 반환합니다. 이 요청은 입력을 서버로 보냅니다.

curl -fsS https://api.dev.packetrove.com/v1/range-to-cidrs \
  -H 'Content-Type: application/json' \
  -d '{"start":"203.0.113.11","end":"203.0.113.23"}'

이 예제는 203.0.113.11/32, 203.0.113.12/30, 203.0.113.16/29를 반환하며 정확히 13개 주소를 나타냅니다.

POST /v1/certificate-bundle

PEM 인증서와 선택적 DNS 호스트 이름을 서버로 보내 원래 위치, 후보 서명, 근거와 다음 단계를 받습니다. 개인 키는 거부하며 결과는 클라이언트 신뢰를 증명하지 않습니다.

curl -fsS https://api.dev.packetrove.com/v1/certificate-bundle \
  -H 'Content-Type: application/json' \
  -d '{"pem":"-----BEGIN CERTIFICATE-----\nMIICCjCCAbCgAwIBAgIBCDAKBggqhkjOPQQDAjBEMRowGAYDVQQDExFEZW1vIElu\ndGVybWVkaWF0ZTEmMCQGA1UEChMdUGFja2V0cm92ZSBTeW50aGV0aWMgRXhhbXBs\nZXMwHhcNMjAwMTAxMDAwMDAwWhcNNDAwMTAxMDAwMDAwWjBGMRwwGgYDVQQDExNz\nZXJ2aWNlLmV4YW1wbGUuY29tMSYwJAYDVQQKEx1QYWNrZXRyb3ZlIFN5bnRoZXRp\nYyBFeGFtcGxlczBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABB5fn3dU7OLbmhjX\np3yyIx+2XV+Tm2SLDoKzqkh1tghkRRujbnOabparI3MRHv4xHE6OePpzrbjxRhRP\n6zFolZWjgZAwgY0wDAYDVR0TAQH/BAIwADAOBgNVHQ8BAf8EBAMCB4AwHQYDVR0O\nBBYEFAfVEb9iWb+ZcGsM/Kn4GuAuzRDBMB8GA1UdIwQYMBaAFLVIZXp5pvnton0C\nEDqX/742N1ieMC0GA1UdEQQmMCSCE3NlcnZpY2UuZXhhbXBsZS5jb22CDSouZXhh\nbXBsZS5uZXQwCgYIKoZIzj0EAwIDSAAwRQIgVEcSRPkS5CuPS5aocD9DJHzXlrc1\nPdUma+rZtx2bN0UCIQD1C3NNIDmH1Xy4oJhwfKWcITyxyIXmlcK9pUiMjD+qdg==\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIB1zCCAX2gAwIBAgIBAzAKBggqhkjOPQQDAjA+MRQwEgYDVQQDEwtEZW1vIFJv\nb3QgQTEmMCQGA1UEChMdUGFja2V0cm92ZSBTeW50aGV0aWMgRXhhbXBsZXMwHhcN\nMjAwMTAxMDAwMDAwWhcNNDAwMTAxMDAwMDAwWjBEMRowGAYDVQQDExFEZW1vIElu\ndGVybWVkaWF0ZTEmMCQGA1UEChMdUGFja2V0cm92ZSBTeW50aGV0aWMgRXhhbXBs\nZXMwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARt9zn152ODLv2A7zMzZjK+5+8h\niuosIcwmRwEhVU/hxg0g22S/EppbLGahIl9r+gyjv1Z9cm4AYzWJ21qQ8xkpo2Yw\nZDASBgNVHRMBAf8ECDAGAQH/AgEBMA4GA1UdDwEB/wQEAwICBDAdBgNVHQ4EFgQU\ntUhlenmm+e2ifQIQOpf/vjY3WJ4wHwYDVR0jBBgwFoAUG028VQAIWmJos9X4aPvx\nebvw8dEwCgYIKoZIzj0EAwIDSAAwRQIhAJuznXANK1Rdaa0ukjaLMvVEx8L1vLVz\n8o4jwLtPmbFKAiB6koDuWdkdLRxnMQ43X2ze1SRy665HHyfQemuCjzrQjw==\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIBsDCCAVagAwIBAgIBATAKBggqhkjOPQQDAjA+MRQwEgYDVQQDEwtEZW1vIFJv\nb3QgQTEmMCQGA1UEChMdUGFja2V0cm92ZSBTeW50aGV0aWMgRXhhbXBsZXMwHhcN\nMjAwMTAxMDAwMDAwWhcNNDAwMTAxMDAwMDAwWjA+MRQwEgYDVQQDEwtEZW1vIFJv\nb3QgQTEmMCQGA1UEChMdUGFja2V0cm92ZSBTeW50aGV0aWMgRXhhbXBsZXMwWTAT\nBgcqhkjOPQIBBggqhkjOPQMBBwNCAAS+Zp+N67NDEXRI1BrIw/iBk6raReb/UqYN\nsOaEVJZANsmih5h7VYPyJnAn5eJbU4uE/ebeZ7aSrFvHOu7EplDZo0UwQzASBgNV\nHRMBAf8ECDAGAQH/AgEDMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUG028VQAI\nWmJos9X4aPvxebvw8dEwCgYIKoZIzj0EAwIDSAAwRQIhAJk5L1v5StGaAboH6L4Z\nKOA71UEUUb2Y0pIbQsBL7Uq2AiBgIVRaev+zDSY0jTRmgIWTkR+49B/E3WWeOfBm\nmMB+/Q==\n-----END CERTIFICATE-----","hostname":"service.example.com"}'

공개 합성 인증서입니다. 문서 평가 시각: 2026-10-04T06:00:00.000Z. 실제 검사는 현재 실행 환경의 시계를 사용합니다.

GET /v1/public-ip

현재 HTTP 연결에서 관찰한 공인 IP를 반환합니다. 주소와 줄 바꿈을 받으려면 text/plain을, 주소와 주소 체계를 받으려면 application/json을 요청하세요. 응답은 캐시되지 않습니다. VPN이나 프록시를 사용하면 관찰되는 출구 주소가 달라집니다.

curl -fsS https://api.dev.packetrove.com/v1/public-ip -H 'Accept: text/plain'

API 문서

엔드포인트 개요 및 예제