L'API de SSLmarket pour simplifier vos commandes SSL

Afin de faciliter les commandes des certificats SSL, SSLmarket a développé un service d'automatisation "API". Vous pouvez facilement télécharger votre certificat émis sur votre compte client. Découvrez comment notre API vous aide à économiser du temps !

L'API vous aide à économiser du temps surtout lorsque vous commandez plus d'un certificat. Il permet d'accélérer les commandes et peut vous éviter de perdre du temps. Ainsi, vous pouvez vous concentrer sur votre business !

Processus simplifié par l'API de SSLmarket

L'API (Application Programming Interface) de SSLmarket vous permet de commander tous les types de certificats (à l'exception des produits qui ne peuvent pas être automatisés). Il suffit de remplir tous les champs obligatoires du formulaire de commande et votre commande sera prise en compte. L'API supporte tous les paramètres du certificat, y compris les SAN (possibilité d’ajouter d’autres domaines).

  • Pour tout type de certificat (sauf quelques exceptions)
  • Téléchargement du certificat simple
  • Définition de tous les paramètres de la commande
  • Commande en un clic (à l'aide de l'outil)
  • Processus accéléré pour vous éviter de perdre du temps
  • Possibilité de définir des données de votre entreprise par défaut

Comment utiliser l'API de SSLmarket

L'API peut être utilisée de deux façons. La méthode recommandée est l'implémentation dans votre système ou votre propre interface pour commander des certificats. Pour ce faire, il suffit de connaître les informations ci-dessous. La deuxième méthode convient aux clients qui ne savent pas programmer ou qui n'ont pas de programmeur disponible. Notre nouvel interface que nous préparons actuellement, vous permettra de passer facilement une commande à l'aide de l'API, sans implémentation côté client. Ainsi, vous accélérerez votre travail et la gestion des certificats.

Commencer avec l'API de SSLmarket

L'API de SSLmarket peut utiliser chaque de nos clients, rapidement et sans contraintes administratives. Il vous suffit de vous connecter à votre espace client et activer "Accéder au compte client via l'API" (Paramètres du compte). Cela vous permet de générer une clé API individuelle pour accéder à l'API SSLmarket (la clé est générée pour l'espace client concret). Vous pouvez ensuite passer la documentation à votre programmeur.

Pour appeler l'API utilisez l'URL suivant : https://www.sslmarket.fr/api

Authentification des demandes

L'entête de tout requête HTTP doit contenir un token d'authentification d'accès (X-Auth-Token). Après avoir activé "Accéder au compte client via l'API", vous le trouverez également dans les Paramètres du compte.

GET /api/order/list HTTP/1.1
Host: sslmarket.fr
X-Auth-Token: {{AUTH_TOKEN}}

Valeurs de données renvoyées

Après un appel d'endpoint réussi, l'API renvoie un code de réponse HTTP 2XX. Après un appel d'endpoint non réussi, l'API renvoie un code de réponse HTTP 4XX ; le corps de la réponse contient le type d'erreur (string) et son description.

Fonctions disponibles de l'API

Veuillez trouver ci-dessous une liste des fonctions API que vous utiliserez pour commander et télécharger les certificats numériques de notre offre.

Chaque fonction est accessible via son endpoint, auquel vous envoyez une requête contenant les paramètres nécessaires pour appeler la fonction. Les paramètres d'entrée se distinguent en deux catégories : obligatoires, que vous devez envoyer dans la demande, et non obligatoires (facultatifs). Chaque fonction contient son utilisation, l'adresse de l'endpoint, la description des paramètres d'entrée et de sortie et le format de la réponse.

La fonction renvoie la liste des produits disponibles dans l'API.

GET /product/list
  • Codes de réponse HTTP : 200
  • Réponse au format de données : application/json

Paramètres de sortie

Nom Type Description
products array
.. product_type string Type de produit. Valeur de paramètre ssl_certificateou client_certificate
.. product_code string Code de produit
.. title string Nom de produit
.. type string Autorité de certification
.. validate_type string Type de validation SSL. Valeur de paramètre dv, ov ou ev
.. csr_required string CSR obligatoire. Valeur de paramètre true ou false
.. max_years string Durée de validité maximale
.. min_san_values int Nombre de SAN minimum
.. max_san_values int Nombre de SAN maximum

  
{
    "products": [
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-standard-ssl",
            "type": "DigiCert",
            "title": "Standard SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-wildcard",
            "type": "DigiCert",
            "title": "WildCard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-ev-ssl",
            "type": "DigiCert",
            "title": "EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-geotrust-standard-dv-ssl",
            "type": "GeoTrust",
            "title": "DV SSL",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-geotrust-wildcard-dv",
            "type": "GeoTrust",
            "title": "DV SSL Wildcard",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "rapidssl-rapidssl-dv",
            "type": "RapidSSL",
            "title": "RapidSSL DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-client-premium-class-1",
            "type": "DigiCert",
            "title": "Client Premium Class 1",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-ssl",
            "type": "DigiCert",
            "title": "Secure Site SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-123-dv",
            "type": "Thawte",
            "title": "SSL 123 DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-client-premium-class-2",
            "type": "DigiCert",
            "title": "Client Premium Class 2",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "rapidssl-rapidssl-wildcard-dv",
            "type": "RapidSSL",
            "title": "RapidSSL Wildcard DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ov",
            "type": "GeoTrust",
            "title": "TrueBusiness ID OV",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ov",
            "type": "Thawte",
            "title": "SSL Webserver OV",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ssl",
            "type": "DigiCert",
            "title": "Secure Site Pro SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ov-wildcard",
            "type": "Thawte",
            "title": "SSL Webserver OV Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ov-wildcard",
            "type": "GeoTrust",
            "title": "TrueBusiness ID OV Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-individual-500",
            "type": "DigiCert",
            "title": "Document Signing - Individual (500)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-ev-ssl",
            "type": "DigiCert",
            "title": "Secure Site EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ev",
            "type": "GeoTrust",
            "title": "TrueBusiness ID EV",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ev",
            "type": "Thawte",
            "title": "SSL Webserver EV",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-individual-2000",
            "type": "DigiCert",
            "title": "Document Signing - Individual (2000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ev-ssl",
            "type": "DigiCert",
            "title": "Secure Site Pro EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-organization-2000",
            "type": "DigiCert",
            "title": "Document Signing Organization (2000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "client_certificate",
            "product_code": "quovadis-rsassa-pss-smime",
            "type": "QuoVadis",
            "title": "RSASSA-PSS S/MIME",
            "validate_type": "qv",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-wildcard-ssl",
            "type": "DigiCert",
            "title": "Secure Site Wildcard SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-organization-5000",
            "type": "DigiCert",
            "title": "Document Signing Organization (5000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ssl-wildcard",
            "type": "Digicert",
            "title": "Secure Site Pro Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        }
    ]
}
 

La fonction permet d'insérer une nouvelle commande sur le compte client.

POST /order/certificate/{{PRODUCT_CODE}}
  • {{PRODUCT_CODE}} - code de produit
  • HTTP réponse status code : 201
  • Request data format : application/json
  • Réponse data format : application/json

Paramètres d'entrée

Nom Type Obligatoire Description
domaine string oui Nom de domaine
dns_names array no Noms de domaine ajoutés aux SAN
years int oui Validité du certificat
csr string oui* Requête CSR
voucher string non Coupon de réduction
dv_auth_method string non Méthode de vérification du propriétaire d'un nom de domaine. Les valeurs acceptées sont e-mail, FILE ou DNS. La valeur par défault est e-mail
owner_name string oui Nom du titulaire du certificat
owner_street string oui Rue du propriétaire
owner_city string oui Ville du propriétaire
owner_zip string oui Code postal du propriétaire
owner_country string oui Code de pays à deux lettres (ISO 3166-1 alpha-2)
owner_tel string oui Téléphone du titulaire du certificat au format +33.554112554
auth_title string oui
auth_firstname string oui Prénom du titulaire du certificat
auth_lastname string oui Nom du titulaire du certificat
auth_tel string oui Téléphone du titulaire du certificat au format +33.554112554
auth_email string oui E-mail du titulaire du certificat
tech_title string oui
tech_firstname string oui Nom du contact technique du certificat
tech_lastname string oui Prénom du contact technique du certificat
tech_email string oui E-mail du contact technique du certificat
tech_tel string oui Téléphone du contact technique du certificat au format +33.554112554
invoice_name string oui Nom de facturation
invoice_street string oui Rue de l'adresse de facturation
invoice_city string oui Ville de l'adresse de facturation
invoice_zip string oui Code postal de l'adresse de facturation
invoice_country string oui Code de pays de facturation à deux lettres (ISO 3166-1 alpha-2)
invoice_email string oui E-mail de facturation
invoice_ic string non N° SIREN
invoice_dic string non Numéro de TVA

* Dépend du type de certificat

Paramètres de sortie

Le numéro de commande est le numéro interne de SSLmarket ; vous pouvez l'utiliser dans la recherche.

Nom Type Description
order_id int Numéro de commande

La fonction affiche toutes les commandes du compte client.

GET /order/list
  • Codes de statut de réponse HTTP : 200
  • Réponse data format : application/json

Paramètres d'entrée

Nom Type Description
orders array Champ des commandes
.. order_id int Numéro de commande
.. product_type string Type de produit
.. product_code string Code de produit
.. domain string Nom de domaine dans le certificat
.. dns_names array Noms de domaine aux SAN
.. sans_order_count int Nombre de SAN insérés dans la commande
.. years int Validité du certificat
.. inserted datetime Date/heure de l'insertion de la commande
.. published datetime Date/heure de l'émission du certificat
.. expired date Date de fin de validité du certificat

La fonction affiche les détails de la commande (disponibles également sur l'espace client).

GET /order/order_id/{{ORDER_ID}}
  • {{ORDER_ID}} - Numéro de commande
  • Codes de statut de réponse HTTP : 200
  • Réponse data format : application/json

Paramètres de sortie

Nom Type Description
product_type string Type de produit
product_code string Code de produit
domain string Nom de domaine pour lequel vous demandez le certificat
dns_names array Champ de domaines aux SANs
sans_order_count int Nombre de SANs dans la commande
years int Validité du certificat
csr string Requête CSR pour le certificat
owner_name string Nom du titulaire du certificat
owner_street string Rue
owner_city string Ville
owner_zip string Code postal
owner_country string Code de pays à deux lettres (ISO 3166-1 alpha-2)
owner_tel string Téléphone du titulaire du certificat au format +33.554112554
auth_title string
auth_firstname string Prénom de la personne d'autorisation
auth_lastname string Nom de la personne d'autorisation
auth_tel string Téléphone de la personne d'autorisation au format +33.554112554
auth_email string E-mail de la personne d'autorisation
tech_title string
tech_firstname string Prénom de la personne technique
tech_lastname string Nom de la personne technique
tech_email string E-mail de la personne technique
tech_tel string Téléphone de la personne technique au format +33.554112554
inserted datetime La date et l'heure de la commande
published datetime La date et l'heure de l'émission du certificat
expired date La date et l'heure de la fin de validité du certificat
dv_auth_method string Méthode de vérification du propriétaire du certificat. Le paramètre n'est inclus dans la réponse que si product_type=ssl_certificate
dv_auth_content string Valeur unique pour vérifier le propriétaire du domaine. Le paramètre n'est inclus dans la réponse que si product_type=ssl_certificate a dv_auth_method=DNS nebo dv_auth_method=FILE

La fonction est gratuite et généralement utilisée lorsque la clé privée est perdue. Le certificat est réémis avec les mêmes paramètres et la même date d'expiration que le certificat original.

POST /certificate/order_id/{{ORDER_ID}}/reissue
  • {{ORDER_ID}} - numéro de commande
  • Request data format : application/json
  • Codes de statut de réponse HTTP : 202

Paramètres d'entrée

Nom Obligatoire Type Description
csr oui string Requête CSR pour le certificat

La fonction de révocation invalidera définitivement le certificat. La révocation signifie l'annulation du certificat sans compensation. Il est utilisé en cas d'utilisation abusive de la clé privée du certificat.

PUT /certificate/order_id/{{ORDER_ID}}/revoke
  • Disponible uniquement pour les produits DigiCert Client Premium Class 1 et Client Premium Class 2
  • {{ORDER_ID}} - numéro de commande
  • Codes de statut de réponse HTTP : 202

La fonction est utilisée pour télécharger le certificat émis au format souhaité, que vous spécifiez dans les paramètres d'entrée {{FORMAT}}. PEM est le format de texte en Base64, P7B le format binaire.

GET /certificate/order_id/{{ORDER_ID}}/format/{{FORMAT}}
  • {{ORDER_ID}} - numéro de commande
  • {{FORMAT}} - format du certificat
    • pem_server - renvoie le certificat serveur au format texte Base64.
    • pem_intermediate - renvoie le certificat serveur avec le certificat intermédiaire. Il est nécessaire pour l'installation du certificat. Ce format convient aux serveurs Linux (Apache, nginx etc.).
    • p7b - renvoie le certificat serveur et sa chaîne (certificat intermédiaire + racine) au format binaire P7B (PKCS#7).
  • Codes de statut de réponse HTTP : 200
  • Request data format : text/plain
záchranný kruh sslmarket

Besoin d'aide ?

N'hésitez pas à nous contacter si vous avez la moindre question.

Envoyez-nous un message
info@sslmarket.fr
Question rapide
Appelez-nous
+33 9 79 99 87 23
+33 9 79 99 87 23