API dell'SSLmarket per ordinare i certificati

SSLmarket supporta un API per ordinare certificati TLS. L'API consente di effettuare facilmente gli ordini per quasi tutti i certificati della nostra gamma. Una volta emessi, è anche possibile scaricarli facilmente. Più avanti troverai la documentazione che ti aiuterà a ordinare i certificati tramite l'API, risparmiandoti tempo! L'API torna particolarmente utile se ordini grandi quantità di certificati. Ti aiuterà a velocizzare gli ordini in modo che tu possa concentrarti su ciò che è veramente importante per la tua azienda.

Per un’implementazione facile utilizza la specifica OpenAPI e Swagger.

Come utilizzare l'API dell'SSLmarket

L'API può essere utilizzata in due modi. Il modo consigliato è quello di implementarla completamente nel tuo sistema o nell'interfaccia per l'ordinazione dei certificati. Puoi farlo facilmente basandoti su questa documentazione. Attenendoti alla specifica OpenAPI creerai con noi una specifica completa; la sua successiva integrazione sarà molto facile.

Il secondo modo è adatto ai clienti che non sanno programmare o non dispongono di un programmatore. Utilizzando una semplice interfaccia utente Postman di terzi è possibile effettuare facilmente un ordine utilizzando l'API, ma senza alcuna implementazione da parte del cliente. In questo modo, velocizzerai notevolmente la gestione e l'amministrazione dei certificati.

Potrai effettuare gli ordini in modo semplice, senza dover ricontrollare l'intero ordine, e inoltre potrai usare l’API per scaricare i certificati emessi. Ti consigliamo di combinare l'interfaccia Postman con la nostra applicazione SSLmarket per Windows.

Per cominciare con l'API dell'SSLmarket

Tutti i nostri clienti possono cominciare a utilizzare l'API dell'SSLmarket. Non è necessario stipulare alcun contratto né perdere tempo nelle formalità. È sufficiente accedere al tuo account nell'amministrazione clienti e attivare "Accesso all'account tramite API" nelle impostazioni dell'account. Facendo ciò verrà generata una chiave API individuale per accedere all'API dell'SSLmarket (la chiave è connessa con l'account).

Inoltra poi la documentazione al tuo programmatore che potrà recuperarla facilmente dall'endpoint openapi-specification, nel formato di specifica OpenAPI. Il parametro del formato può essere json o yaml. La risposta è in formato application/json oppure application/x-yaml.


    GET https://www.sslmarket.cz/api/openapi-specification/format/json

Potrai importare facilmente la risposta in questo formato nel tuo ambiente o nel tuo strumento (tipo Postman) e iniziare a usare l'API. Puoi anche provare l'API in Swagger. Basta visitare l'URL https://www.sslmarket.cz/api/swagger-ui/.

Autenticazione delle richieste

Tutte le richieste API devono recare, nell'intestazione della richiesta HTTP, il token di autenticazione di accesso (X-Auth-Token). Dopo aver attivato "Accesso all'account tramite API", troverai il token nelle impostazioni dell'account.


GET /api/order/list HTTP/1.1

Host: sslmarket.cz

X-Auth-Token: {{AUTH_TOKEN}}

Valori restituiti

Dopo una chiamata all'endpoint riuscita, l'API restituisce un codice di stato HTTP 2XX. In caso di chiamata fallita, l'API restituisce un codice di stato 4XX; nel corpo della risposta troverai il tipo di errore (la stringa) e una descrizione dell'errore.

Funzioni disponibili dell'API dell'SSLmarket

Più avanti troverai un elenco delle funzioni dell'API che puoi utilizzare per ordinare e scaricare tutti i certificati digitali della nostra gamma.

Ogni funzione è accessibile tramite il proprio endpoint al quale invii una richiesta contenente i parametri necessari per chiamare la funzione in questione. I parametri di ingresso si distinguono in quelli obbligatori, che devono essere inviati nella richiesta, e in quelli opzionali (facoltativi). Per ogni funzione è necessario specificare il suo utilizzo, l'indirizzo dell'endpoint, la descrizione dei parametri di ingresso e di uscita, nonché il formato della risposta.

Per generare la specifica OpenAPI - inizia con questo passaggio (vedi il paragrafo Per cominciare con l'API dell'SSLmarket)
Lista dei prodotti
Inoltro del mail DCV
Inserimento di un nuovo ordine
Lista degli ordini
Dettagli dell'ordine
Modifica dell'ordine
Riemissione del certificato
Cancellazione della riemissione del certificato
Revoca del certificato
Download del certificato
Decodificatore di CSR
Decodificatore del certificato
OCSP check