Documentation de l’API
Spécification OpenAPI ↗Explorez les points d’accès, copiez des exemples de requêtes et essayez l’API sans compte ni clé API. L’envoi d’une requête transmet ses données à l’API. Les recherches d’IP publique indiquent la connexion de votre navigateur.
Lire le guide de connexion MCPLa référence interactive et la spécification sont en anglais.
POST /v1/cidr-cover
Envoyez des adresses IPv4 ou IPv6 et des plages CIDR en JSON. La réponse contient le CIDR englobant minimal, les entrées normalisées et les nombres exacts d’adresses sous forme de chaînes décimales. Cette requête API envoie vos entrées au serveur.
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"]}'Cet exemple renvoie 203.0.113.0/29 avec 5 adresses supplémentaires. Vérifiez additionalAddressCount avant d’utiliser le résultat dans une liste d’adresses autorisées ou bloquées.
POST /v1/cidr-subtract
Soustrayez exactement exclude de include. Renvoie une liste minimale de CIDR canoniques et des nombres d’adresses exacts sous forme de chaînes décimales. Cet appel envoie les données au serveur.
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"]}'Cet exemple renvoie 203.0.113.0/26, 203.0.113.128/25, avec 192 adresses restantes et aucune couverture supplémentaire.
POST /v1/range-to-cidrs
Envoyez start et end de la même famille. Les deux bornes sont incluses. Renvoie les bornes canoniques, la liste CIDR minimale exacte, le nombre de CIDR et le nombre d’adresses en chaîne décimale. Cette requête envoie les entrées au serveur.
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"}'Cet exemple renvoie 203.0.113.11/32, 203.0.113.12/30, 203.0.113.16/29, représentant exactement 13 adresses.
POST /v1/certificate-bundle
Envoyez les certificats PEM et un nom DNS facultatif au serveur. Recevez positions d’origine, signatures candidates, faits et prochaines étapes. Les clés privées sont refusées ; les résultats ne prouvent pas la confiance 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"}'Certificats publics synthétiques. Date documentaire : 2026-10-04T06:00:00.000Z. Votre vérification utilise l’horloge actuelle de l’environnement.
GET /v1/public-ip
Renvoie l’IP publique observée pour cette connexion HTTP. Demandez text/plain pour une adresse suivie d’un saut de ligne ou application/json pour une adresse et sa famille. Les réponses ne sont pas mises en cache. Un VPN ou un proxy modifie l’adresse de sortie observée.
curl -fsS https://api.staging.packetrove.com/v1/public-ip -H 'Accept: text/plain'