Documentazione API
Specifica OpenAPI ↗Esplora gli endpoint, copia esempi di richieste e prova l’API senza account né chiave API. L’invio di una richiesta trasmette i dati all’API. La ricerca dell’IP pubblico osserva la connessione del browser.
Leggi la guida di connessione MCPIl riferimento interattivo e la specifica sono in inglese.
POST /v1/cidr-cover
Invia indirizzi IPv4 o IPv6 e intervalli CIDR in formato JSON. La risposta include il CIDR minimo di copertura, le voci normalizzate e i conteggi esatti degli indirizzi come stringhe decimali. Questa richiesta API invia i dati al server.
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"]}'Questo esempio restituisce 203.0.113.0/29 con 5 indirizzi aggiuntivi. Controlla additionalAddressCount prima di usare il risultato in un elenco di indirizzi consentiti o bloccati.
POST /v1/cidr-subtract
Sottrai esattamente exclude da include. Restituisce un elenco minimo di CIDR canonici e conteggi esatti come stringhe decimali. Questa chiamata invia i dati al server.
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"]}'Questo esempio restituisce 203.0.113.0/26, 203.0.113.128/25, con 192 indirizzi rimanenti e nessuna copertura aggiuntiva.
POST /v1/range-to-cidrs
Invia start ed end della stessa famiglia. Entrambi gli estremi sono inclusi. Restituisce estremi canonici, lista CIDR minima esatta, numero di CIDR e conteggio indirizzi come stringa decimale. La richiesta invia dati al server.
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"}'Questo esempio restituisce 203.0.113.11/32, 203.0.113.12/30, 203.0.113.16/29, rappresentando esattamente 13 indirizzi.
POST /v1/certificate-bundle
Invia certificati PEM e un nome DNS facoltativo al server. Ricevi posizioni originali, firme candidate, riscontri con evidenze e prossimi passi. Le chiavi private sono rifiutate; il risultato non prova la fiducia del client.
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"}'Certificati pubblici sintetici. Ora documentata: 2026-10-04T06:00:00.000Z. Il controllo usa l’orologio attuale dell’ambiente.
GET /v1/public-ip
Restituisce l’IP pubblico osservato per questa connessione HTTP. Richiedi text/plain per un indirizzo seguito da un carattere di nuova riga oppure application/json per un indirizzo e la sua famiglia. Le risposte non vengono memorizzate nella cache. Una VPN o un proxy cambia l’indirizzo di uscita osservato.
curl -fsS https://api.staging.packetrove.com/v1/public-ip -H 'Accept: text/plain'