L'API REST d'Esadax fournit plusieurs points de terminaison pour gérer les certificats. Ces points de terminaison vous permettent de récupérer, de créer, de mettre à jour et de supprimer des certificats associés à votre compte ou à votre équipe.

Vue d ' ensemble

L'API Certs vous permet d'interagir avec les enregistrements de certificat stockés dans le système Esadax. Chaque certificat peut être identifié par son id unique et est associé à une équipe spécifique. L'API prend en charge diverses opérations telles que la récupération d'un certificat par ID, l'émission de nouveaux certificats, la mise à jour des certificats existants et leur suppression.

Points d ' évaluation

1. Développement durable Obtenir Cert par ID

• Méthode: GET
• URL: /v7/certs/{id}
• Paramètre de chemin: id (obligatoire)
• Paramètres de la requête: slug, teamId
• Réponse : Renvoie les détails du certificat, y compris autoRenew, cns, createdAt, expiresAt et id.

2. Émettre un nouveau certificat

• Méthode : POST
• URL: /v7/certs
• Paramètres de la requête: slug, teamId
• Corps de la requête : Contient un tableau de chaînes de noms communs (CNS) sous la clé cns.
• Réponse : Renvoie les détails du certificat nouvellement créé.

3. Développement Télécharger un Cert

• Méthode : PUT
• URL: /v7/certs
• Paramètres de la requête: slug, teamId
• Entité demandeuse : Comprend ca (Autorité de certification), cert (contenu du certificat), key (clé privée) et, en option, skipValidation.
• Réponse : Renvoie les détails du certificat mis à jour.

4. Développement Supprimer un certificat

• Méthode: SUPPRIMER
• URL: /v7/certs/{id}
• Paramètre de chemin: id (obligatoire)
• Paramètres de la requête: slug, teamId
• Réponse : Supprime le certificat spécifié du système.

Authentification

Tous les appels API nécessitent un jeton d'autorisation, qui doit être inclus dans les en-têtes de requête sous la forme Authorization: Bearer {token}.

Codes de réponse

L'API utilise des codes d'état HTTP standard pour indiquer le succès ou l'échec. Par exemple :

• 200 OK: Indique une opération réussie.
• 400 Bad Request: S'il y a un problème avec les paramètres de la requête.
• 403 Forbidden : Lorsque l'utilisateur n'a pas les autorisations nécessaires pour effectuer l'action.

Cette documentation fournit des détails complets sur la façon d'interagir avec le système de gestion de certificats d'Esadax via leur API REST. Assurez-vous de passer en revue les exigences spécifiques de chaque point de terminaison avant de les implémenter dans votre application.