API TBS CERTIFICATS
L'API TBS CERTIFICATS vous permet d'automatiser diverses opérations liées à vos certificats comme la commande, la vérification d'état ou le renouvellement de vos certificats. L'API TBS CERTIFICATS est basée sur XML-RPC.
Des exemples d'implémentation sont fournis en PHP, à l'aide de la bibliothèque phpxmlrpc 3.
Une référence complète d'API est aussi disponible et sera référencée à plusieurs reprises dans cette documentation.
Opérations de listing
Une seconde API, en mode REST, vous permet de lister vos demandes en cours et vos certificats en cours de validité : consulter la documentation.
Liste de diffusion
Une liste de diffusion (mailing list) est disponible afin de recevoir des informations sur le développement de l'API et sur les mises a jour de sa documentation. Pour s'inscrire, il suffit d'envoyer un mél à l'adresse suivante : tag-apitbsfr-subscribe@mxa.clust1.tbs-internet.net.
Comment procéder ?
Dans un premier temps, il convient de tester les différentes fonctionnalités de l'API. Vous pouvez le faire grace à notre SANDBOX. Il va donc falloir créer un compte sur notre SANDBOX et ensuite créer un utilisateur API. Voici les étapes à suivre :
- Rendez-vous sur cette page
- Renseignez les différents champs demandés et cliquez sur "Créer le compte".
- Le compte doit être activé manuellement par nos équipes. Patientez jusqu'à recevoir le mail de confirmation d'activation.
- Une fois le compte activé, rendez-vous sur cette page pour vous connecter.
- Dans le panneau de gauche, partie "Administration", cliquez sur "Utilisateurs".
- Cliquez sur "Ajouter un utilisateur API" et choisissez l'identifiant et le mot de passe.
Une fois l'utilisateur API créé, renseignez l'identifiant et mot de passe choisis dans votre script/logiciel/code.
Par la suite, une fois que vous êtes prêts pour passer en production, il faut procéder exactement de la même façon en vous connectant sur votre compte public.
Informations de connexion
Les requêtes sont à effectuer sur ces serveurs :
| IPv6 | IPv4 | Détection automatique de l'IP | |
|---|---|---|---|
| PRODUCTION | publicapi6.tbs-certificats.com
port : 443 |
publicapi4.tbs-certificats.com
port : 443 |
publicapi.tbs-certificats.com
port : 443 |
| SANDBOX | apisandbox6.or2.clust2.tbs-internet.net
port : 443 |
apisandbox4.or2.clust2.tbs-internet.net
port : 443 |
apisandbox.or2.clust2.tbs-internet.net
port : 443 |
Liste des produits disponibles via l'API
| Code Produit | Nom Produit | Durée de vie | Licences | SAN | SAN wildcard | SAN de domaine |
|---|---|---|---|---|---|---|
| ssl | Thawte SSL Standard | 1-2-3 | - | - | ||
| sslev | Thawte SSL EV | 1-2-3 | - | - | - | |
| wssl | Thawte SSL Wildcard | 1-2-3 | - | - | - | - |
| PSbasic | Basic DV | 1-2-3-4-5 | - | - | - | - |
| PSbasicMulti | Basic DV Multiples Sites (3+) | 1-2-3-4-5 | - | - | ||
| PSbasictest | Basic DV test | 30j | - | - | - | - |
| PSbasicW | Basic DV Web | 1-2-3-4-5 | - | - | - | - |
| PSbasicwild | Basic DV Wildcard | 1-2-3-4-5 | - | - | - | - |
| PSbasicWtest | Basic DV Web test | 30j | - | - | - | - |
| PSfreeW90 | Free DV Web | 90j | - | - | - | - |
| X509s2m100dom | TBS X509 100 Multiples Sites | 1-2 | - | - | - | |
| X509s2m12dom | TBS X509 12 Multiples Sites | 1-2 | - | - | - | |
| X509s2m40dom | TBS X509 40 Multiples Sites | 1-2 | - | - | - | |
| X509s2wild | TBS X509 Omnidomaine | 1-2 | - | - | - | |
| X509SHA256e | TBS X509 Ecommerce | 1-2 | - | - | - | - |
| X509SHA256p | TBS X509 Premium | 1-2 | - | - | - | - |
| X509SHA256s | TBS X509 Standard | 1-2 | - | - | - | - |
| digivmc | DigiCert VMC | 1-2-3 | - | - | - | |
| global | DigiCert SSL Secure Site Pro | 1-2-3 | - | - | ||
| globalev | DigiCert Secure Site Pro EV | 1-2-3 | - | - | - | |
| secure | DigiCert SSL secure | 1-2-3 | - | - | ||
| secureev | DigiCert Secure Site EV | 1-2-3 | - | - | - | |
| HAaseal | Harica cachet avancé | 1-2 | - | - | - | - |
| HAasealpsd | Harica cachet avancé PSD2 | 1-2 | - | - | - | - |
| HAqseal | Harica cachet qualifié sur token | 1-2 | - | - | - | - |
| HAqsealHSM | Harica cachet qualifié sur HSM distant | 1-2 | - | - | - | - |
| HAqsealpsd | Harica cachet qualifié PSD2 | 1-2 | - | - | - | - |
| HAqwac | Harica QWAC | 1-2 | - | - | - | - |
| HAqwacpsd | Harica QWAC-PSD2 | 1-2 | - | - | - | - |
| HAsealpsdtest | Harica test cachet PSD2 | 1 | - | - | - | - |
| HAwacpsdtest | Harica test WAC PSD2 | 1 | - | - | - | - |
| rapidssl | Geotrust RapidSSL | 1-2-3 | - | - | - | - |
| rapidsslw | Geotrust RapidSSL Wildcard | 1-2-3 | - | - | - | - |
| tbidev | GeoTrust True BusinessID avec EV | 1-2-3 | - | - | - | |
| tbidevm | GeoTrust True BusinessID avec EV Multi 5+ | 1-2-3 | - | - | - | |
| tbizwild | Geotrust True BusinessID Wildcard | 1-2-3 | - | - | - | - |
| truebiz | Geotrust True BusinessID | 1-2-3 | - | - | - | - |
| truebizm | Geotrust True BusinessID Multi 5+ | 1-2-3 | - | - | ||
| COM12s2ucc | Sectigo UCC (12+) | 1-2-3-4-5 | - | - | ||
| COM2wild | Sectigo MultiWild (2+) | 1-2-3-4-5 | - | - | ||
| COM3s2ucc | Sectigo UCC (3+) | 1-2-3-4-5 | - | - | ||
| COMqwac | Sectigo Certificat QWAC pour personne morale | 1-2-3 | - | - | - | - |
| COMqwac3+ | Sectigo Certificat QWAC 3+ pour personne morale | 1-2-3 | - | - | - | |
| COMs2ssl | Sectigo SSL | 1-2-3-4-5 | - | - | - | - |
| COMs2wild | Sectigo WildSSL | 1-2-3-4-5 | - | - | - | - |
| COMvpro | Sectigo Intel vPro | 1-2 | - | - | - | - |
| globdomssl | GlobalSign DomainSSL | 1 | - | - | ||
| globextssl | GlobalSign ExtendedSSL | 1 | - | - | - | |
| globorgssl | GlobalSign OrganizationSSL | 1 | - | - | - | |
| globovwssl | GlobalSign OrganizationSSL Wildcard | 1 | - | - | - | - |
| globucc3ssl | GlobalSign UCC 3+ | 1 | - | - | - |
Toolkit
Nous mettons à votre disposition un toolkit pour tester rapidement l'API.
Cet outil vous propose un formulaire à remplir pour obtenir le XML brut attendu par le serveur grâce à l'option « Afficher uniquement la structure XML envoyée ».
Il est possible d'effectuer de vrais appels vers l’environnement sandbox pour tester les requêtes et de charger des profils JSON pré-remplis afin d’éviter la saisie manuelle des données.
Utilisation
- Sélectionnez le serveur : environnement de développement, de test, IPv4, IPv6...
- Remplissez le formulaire :
- renseignez les champs requis dans l’interface
- ou chargez un profil : sélectionnez un profil JSON pour pré-remplir
automatiquement le formulaire
- Choisissez la méthode à utiliser : achat, renouvellement, refabrication...
- Affichez le XML : en sélectionnant « Afficher uniquement la structure XML envoyée », visualisez le XML brut attendu par le serveur