API gratuite
ImmuniWeb vous fournit une API gratuite pour tester vos serveurs SSL / TLS. Pour garantir une vitesse de service et une disponibilité élevées pour tous, l’API gratuite autorise 50 demandes au total pendant 24 heures, à partir d’une adresse IP.
Pour éviter les abus, un mécanisme de protection a été établi pour éliminer la possibilité de tester les adresses IP qui ne sont pas liées au nom de domaine testé. En conséquence, si un nom de domaine est résolu en plusieurs adresses IP, une deuxième demande sera obligatoire, en spécifiant l'une des adresses IP auxquelles le serveur a répondu avec le jeton émis (voir les exemples ci-dessous). Toutefois, si le nom de domaine testé peut être résolu en une seule adresse IP, il sera immédiatement testé.
En outre, il existe différents niveaux d'utilisateurs, chacun offrant un niveau d'utilisation différent avec l'API.
Avis de licence: L'API est fourni gratuitement à des fins privées et commerciales. Si vous utilisez l'API pour le service public disponible (commercial ou non), un lien vers la version d'évaluation gratuite du serveur SSL ImmuniWeb est obligatoire.
API commerciale
ImmuniWeb fournit un accès commercial à l'API de test de sécurité SSL sans restrictions. Adaptées à vos besoins, les restrictions de l’API gratuite peuvent être partiellement ou totalement éliminées. Les prix commencent à 200 USD par mois.
Les institutions académiques, de recherche et à but non lucratif peuvent demander gratuitement une API commerciale. Veuillez envoyer les conditions d'utilisation de votre API pour des informations supplémentaires.
Documentation sur l'API et procédures
Documentation complète de l'API
Spécifications de l'API
| Nom du champ | Valeur |
|---|---|
| Protocole | HTTPS |
| type de demande | ENVOYER |
| URL | https://www.immuniweb.com/ssl/api/v1/check/[ustamp].html: où "ustamp" est un horodatage UNIX arbitraire (il doit s'agir d'un nombre entier). Cette construction est faite pour éviter la mise en cache du côté client. |
Spécification des données POST
| Nom du champ | Valeur |
|---|---|
| Clé API | jeton secret que vous envoyez avec la demande |
| domaine: port | il doit s'agir d'un nom de domaine valide ou d'une adresse IP, suivi d'un numéro de port. Si le port n'est pas fourni, 443 est utilisé par défaut. |
| show_test_results | "false" signifie que les résultats du test seront masqués, "true" signifie que les résultats du test seront affichés dans les statistiques. |
| choosen_ip | Adresse IP du serveur testé (si le domaine testé est résolu dans plusieurs directions). |
| vérifier à nouveau | "false" utilisera les résultats du cache si le serveur a été testé au cours des 24 dernières heures, "true" effectuera un nouveau test sans consulter le cache. |
| verbosité | 1 signifie que la sortie sera détaillée, 0 signifie que la sortie sera courte. |
| symbolique | valeur du jeton envoyé par le serveur si le domaine testé est résolu en plusieurs adresses IP. |
Exemple de transaction utilisant CURL
{"debug": true, "id_travail": "2a9e1f1bc92dc0c7a4bde930dff488771eea6d36988208d34163c5496227b8dc", "status": "test_started", "status_id", "status_id"
$ curl -XPOST -d & id_travail = 2a9e1f1bc92dc0c7a4bde930dff488771eea6d36988208d34163c5496227b8dc & # 39; & # 39; https: //www.immuniweb.com/ssl/api/v1/get_result/145145
{"job_id": "2a9e1f1bc92dc0c7a4bde930dff488771eea6d36988208d34163c5496227b8dc", "status": "in_progress", "status_id": 2, "eta" "" Test ""
{"test_id": "c84936eef26eeb8aaef5ffc43f38ddb91adfd90ac27fb416bd0b21fe2edb1004", "status": "test_cached", "status_id": 3, "message": "Le test est mis en cache"}
$ curl -XPOST -d & id = c84936eef26eeb8aaef5ffc43f38ddb91adfd90ac27fb416bd0b21fe2edb1004 & # 39; & # 39; https: //www.immuniweb.com/ssl/api/v1/get_result/1451425590.html'
{"multiple_ips":[« 199.16.156.6″, »199.16.156.102″, »199.16.156.70″, »199.16.156.230 »], "jeton": "68j3OCZLEomtjASxKoObjZXzX7p2M7L0"}
$ Curl -XPOST -d & # 39; domain = twitter.com: 443 & show_test_results = true & revérifier = false & choosen_ip = 199.16.156.230 & verbosité = 1 & token = 68j3OCZLEompaccgggfggggggfggggfgggggfggggggggggggggggggggggggggfgggggggggggggggggggggggggggggggfg & # 39;
{"error": "Le nom de domaine ne peut pas être résolu", "error_id": 7}
Exemple de réponse du serveur