API 文档
OpenAPI 规范 ↗浏览接口、复制请求示例并试用 API，无需账户或 API 密钥。发送请求会将输入提交到 API；公网 IP 查询观察的是浏览器所用连接。
阅读 MCP 接入指南交互式接口文档与规范使用英文。
POST /v1/cidr-cover
通过 JSON 提交 IPv4 或 IPv6 地址及 CIDR 网段。响应包含最小覆盖 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
从包含列表中精确扣除排除列表，返回最少规范 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 IP 地址，范围包含两个端点。返回规范化端点、最少精确 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'