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 |
|---|---|---|---|---|---|---|
| assistance_EC_ | Pack assistance pour compte client | 1-2-3 | - | - | - | - |
| 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 | 30* | - | - | - | - |
| PSbasicW | Basic DV Web | 1-2-3-4-5 | - | - | - | - |
| PSbasicwild | Basic DV Wildcard | 1-2-3-4-5 | - | - | - | - |
| PSbasicWtest | Basic DV Web test | 30* | - | - | - | - |
| PSfreeW90 | Free DV Web | 90* | - | - | - | - |
| X509s2m100dom | TBS X509 100 Multiples Sites | 1-2 | - | - | - | |
| X509s2m12dom | TBS X509 12 Multiples Sites | 1-2 | - | - | - | |
| X509s2m40dom | TBS X509 40 Multiples Sites | 1-2 | - | - | - | |
| X509s2test | TBS X509 Test | 30* | - | - | - | - |
| X509s2wild | TBS X509 Omnidomaine | 1-2 | - | - | - | |
| X509SHA256e | TBS X509 Ecommerce | 1-2 | - | - | - | - |
| X509SHA256p | TBS X509 Premium | 1-2 | - | - | - | - |
| X509SHA256s | TBS X509 Standard | 1-2 | - | - | - | - |
| X509smimeMV | TBS X509 S/MIME Mailbox-Validated | 1-2 | - | - | - | - |
| X509smimeOV | TBS X509 S/MIME Organization-Validated | 1-2 | - | - | - | - |
| digiauthplus | DigiCert Authentification | 1-2 | - | - | - | - |
| digiclipre | Digicert Mél Premium | 1-2 | - | - | - | - |
| digicsmime | Digicert Mél Novice | 1-2 | - | - | - | - |
| digisecempl | DigiCert Secure Mél pour employé | 1-2 | - | - | - | - |
| digisecindi | DigiCert Secure Mél pour boîte mél individuelle | 1-2 | - | - | - | - |
| digisecorg | DigiCert Secure Mél pour Organisation | 1-2 | - | - | - | - |
| digisecplus | DigiCert Mél Chiffrement | 1-2 | - | - | - | - |
| digisigplus | DigiCert Mél Signature | 1-2 | - | - | - | - |
| digivmc | DigiCert VMC | 1-2-3 | - | - | - | |
| digiXN | DigiCert X9 pour mTLS | 1 | - | - | - | - |
| 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 | - | - | - | |
| certiserv | ChamberSign CertiServ Serveur Client RGS* | 1-3 | - | - | - | - |
| eiducio | ChamberSign Eiducio | 1-3 | - | - | - | - |
| eiducio1+ | ChamberSign Eiducio(+) | 1-3 | - | - | - | - |
| initio | ChamberSign Initio ID RGS* | 1-3 | - | - | - | - |
| negocio | ChamberSign Negocio Cachet Signature RGS* | 3 | - | - | - | - |
| HAaseal | Harica cachet avancé | 1-2 | - | - | - | - |
| HAasealpsd | Harica cachet avancé PSD2 | 1-2 | - | - | - | - |
| HAIVsig | Harica IV E-signature Qualified sur token | 1-2-3-4 | - | - | - | - |
| HAOVsig | Harica OV E-signature Qualified sur token | 1-2-3-4 | - | - | - | - |
| 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 | - | - | ||
| COMcodesignEVToken | Sectigo Développeur EV | 1 | - | - | - | - |
| COMcodesignOVToken | Sectigo Développeur OV | 1 | - | - | - | - |
| COMhp | Sectigo HackerProof journalier | 1-2 | - | - | - | - |
| COMhp30 | Sectigo HackerGuardian - Service scan PCI de test | 45* | - | - | - | - |
| COMqscdeidas | Sectigo Certificat QSCD eIDAS qualifié pour personne physique | 3 | - | - | - | - |
| COMqscdeidasempl | Sectigo Certificat QSCD eIDAS qualifié pour employé | 1-2-3 | - | - | - | - |
| COMqwac | Sectigo Certificat QWAC pour personne morale | 1-2-3 | - | - | - | - |
| COMqwac3+ | Sectigo Certificat QWAC 3+ pour personne morale | 1-2-3 | - | - | - | |
| COMs2ev | Sectigo EV | 1 | - | - | - | - |
| COMs2ev3fqdn | Sectigo EV Multiple Sites (3+) | 1-2-3-4-5 | - | - | ||
| COMs2ssl | Sectigo SSL | 1-2-3-4-5 | - | - | - | - |
| COMs2wild | Sectigo WildSSL | 1-2-3-4-5 | - | - | - | - |
| COMscd | Sectigo Certificat eIDAS avancé pour personne physique | 3 | - | - | - | - |
| COMsmimeMV | Sectigo S/MIME Mailbox-Validated | 1-2 | - | - | - | - |
| COMsmimeOV | Sectigo S/MIME Organization-Validated | 1-2 | - | - | - | - |
| COMvmc | Sectigo VMC | 1 | - | - | - | |
| COMvpro | Sectigo Intel vPro | 1-2 | - | - | - | - |
| globaatl | GlobalSign AATL | 1-2-3 | - | - | - | - |
| globdevev | GlobalSign développeur EV | 1 | - | - | - | - |
| globdevov | GlobalSign développeur OV | 1 | - | - | - | - |
| globdomssl | GlobalSign DomainSSL | 1 | - | - | ||
| globextssl | GlobalSign ExtendedSSL | 1 | - | - | - | |
| globorgssl | GlobalSign OrganizationSSL | 1 | - | - | - | |
| globovwssl | GlobalSign OrganizationSSL Wildcard | 1 | - | - | - | - |
| globucc3ssl | GlobalSign UCC 3+ | 1 | - | - | - |
* Validité en jours.
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
Requêtes
Opérations
- Commande
- Refabrication
- Renouvellement
- Révocation
- Renvoi du mél de validation DCV
- Validation du code DCV
- Annulation de commande
Informations
- Statut
- Solde
- En sommeil
- Reference
- Addresses DCV
- Changement Commandes
- Liste des certificats en période de renouvellement