API ドキュメント

エンドポイントの確認、リクエスト例のコピー、API の試用ができます。アカウントや API キーは不要です。リクエストを送ると、その入力が API に送信されます。パブリック IP の確認ではブラウザーの接続を確認します。

対話型リファレンスと仕様は英語です。

POST /v1/cidr-cover

IPv4 または IPv6 のアドレスと CIDR 範囲を JSON で送信します。レスポンスには最小の集約 CIDR、正規化した入力、十進数文字列で表す正確なアドレス数が含まれます。この API リクエストでは入力をサーバーに送信します。

curl -fsS https://api.staging.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.staging.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.staging.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.staging.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.staging.packetrove.com/v1/public-ip -H 'Accept: text/plain'

API ドキュメント

エンドポイントの概要と例