L’API REST di Esadax fornisce diversi endpoint per gestire i certificati. Questi endpoint ti consentono di recuperare, creare, aggiornare ed eliminare i certificati associati al tuo account o team.

Panoramica

L'API Certs consente di interagire con i record di certificati memorizzati nel sistema Esadax. Ogni certificato può essere identificato dal suo id univoco ed è associato a un team specifico. L'API supporta varie operazioni come il recupero di un certificato tramite ID, l'emissione di nuovi certificati, l'aggiornamento di quelli esistenti e la loro eliminazione.

Punti finali

1. Ottenere Cert da ID

• Metodo: GET
• URL: /v7/certs/{id}
• Parametro del percorso: id (obbligatorio)
• Parametri di ricerca: slug, teamId
• Risposta: restituisce i dettagli del certificato inclusi autoRenew, cns, createdAt, expiresAt e id.

2. Rilascio di un nuovo certificato

• Metodo: POST
• URL: /v7/certs
• Parametri di ricerca: slug, teamId
• Corpo della richiesta: contiene una matrice di stringhe di nomi comuni (CNS) sotto la chiave cns.
• Risposta: restituisce i dettagli del certificato appena creato.

3. Carica un Cert

• Metodo: PUT
• URL: /v7/certs
• Parametri di ricerca: slug, teamId
• Oggetto della richiesta: include ca (Autorità di certificazione), cert (contenuto del certificato), key (chiave privata) e, facoltativamente, skipValidation.
• Risposta: restituisce i dettagli del certificato aggiornati.

4. Eliminare un certificato

• Metodo: DELETE
• URL: /v7/certs/{id}
• Parametro del percorso: id (obbligatorio)
• Parametri di ricerca: slug, teamId
• Risposta: rimuove il certificato specificato dal sistema.

Autenticazione

Tutte le chiamate API richiedono un token di autorizzazione, che deve essere incluso nelle intestazioni delle richieste come Authorization: Bearer {token}.

Codici di risposta

L'API utilizza i codici di stato HTTP standard per indicare il successo o l'errore. Per esempio:

• 200 OK: Indica un'operazione riuscita.
• 400 Bad Request: Se c'è un problema con i parametri della richiesta.
• 403 Forbidden: quando l'utente non dispone delle autorizzazioni necessarie per eseguire l'azione.

Questa documentazione fornisce dettagli completi su come interagire con il sistema di gestione dei certificati di Esadax tramite la loro API REST. Assicurati di esaminare i requisiti specifici per ogni endpoint prima di implementarli nell'applicazione.