API de SSLmarket para pedir los certificados

SSLmarket admite una API para pedir los certificados TLS. La API permite realizar fácilmente pedidos de casi todos los tipos de certificados de nuestra oferta. Después de su emisión también los puede descargar fácilmente. ¡Más abajo encontrará una documentación que le ayudará a activar pedidos de los certificados a través de la API y ahorrar su tiempo!

La API le ayudará sobre todo si pide varios certificados. Ayudará a acelerar el pedido y usted puede dedicarse a las cosas realmente importantes para sus negocios.

Funciones importantes de la API de SSLmarket

Mediante la API de SSLmarket (Application Programming Interface) puede pedir casi todos los tipos de certificados que forman parte de nuestra oferta (excepto los productos que no es posible automatizar). Es suficiente enviar toda la información así como lo requiere el formulario de pedido en SSLmarket y el pedido quedará guardado en su cuenta. La API admite todos los parámetros de los certificados incluidos los SANs (otros dominios en el certificado).

  • Pedir todos los tipos de certificados (excepto unos cuantos casos)
  • Descargar fácil el certificado después de su emisión
  • Definir todos los parámetros del pedido
  • Pedir con un solo clic (mediante la herramienta)
  • Acelerar los procesos y ahorrar su tiempo
  • Posible configurar los datos iniciales para su empresa

Cómo utilizar la API de SSLmarket

La API se puede utilizar de dos formas. La forma recomendada es una implementación a su sistema o su propia interfaz para pedir los certificados. Para ello es suficiente conocer la información mencionada más abajo. La segunda forma es apropiada para clientes que no saben programar o no disponen de un programador. Mediante una interfaz sencilla de usuario, que en la actualidad estamos preparando, itroducirá el pedido fácilmente utilizando la API, pero sin implementación por parte del cliente. Así también se acelerará mucho el trabajo con los certificado y su gestión.

Empezando con la API de SSLmarket

La API de SSLmarket la pueden empezar a utilizar todos nuestros clientes. No hay que firmar contratos y perder el tiempo en las formalidades. Es suficiente acceder a su cuenta en la administración de cliente y en la configuración de la cuenta activar "Acceder a la cuenta a través de la API". Así le será generada una clave API individual para acceder a la API de SSLmarket (la clave está ligada a la cuenta de cliente en cuestión). Después entregue la documentación a su programador.

Para la llamada API utilice la siguiente URL: https://www.sslmarket.es/api

Verificación de las peticiones

En todas las preguntas sobre la API debe indicarse, en el encabezamiento HTTP de la pregunta, el token de acceso verificativo (X-Auth-Token). Este lo encontrará en la configuración de la cuenta después de activar 'Acceder a la cuenta a través de la API'.

GET /api/order/list HTTP/1.1
Host: sslmarket.cz
X-Auth-Token: {{AUTH_TOKEN}}

Valores de respuesta

Una llamada exitosa al endpoint envía a la API el código HTTP de la respuesta en el estado 2XX. Una llamada errónea envía a la API el código de la respuesta en el estado 4XX; en el cuerpo de la respuesta encontrará el tipo del error (cadena) y su descripción.

Funciones disponibles de la API de SSLmarket

Más abajo encontrará una lista de las API funcionales, que utilizará para pedir y descargar todos los certificados digitales de nuestra oferta.

A cada una de las funciones se puede acceder a través de un endpoint propio al cual envía la petición que contiene parámetros necesarios para llamar la función concreta. Los parámetros de acceso se dividen en obligatorios, que tiene que enviar en la petición, y no obligatorios (optativos). Junto a cada función se indica su uso, la dirección del endpoint, la descripción de los parámetros iniciales y finales y el formato de la respuesta.

Las funciones envían una lista de productos disponibles en la API.

GET /product/list
  • Código del estado de la respuesta HTTP: 200
  • Formato de datos de la respuesta: application/json

Parámetros finales

Nombre Tipo Descripción
products array
.. product_type string Tipo del producto. El valor del parámetro es ssl_certificate o client_certificate
.. product_code string Código del producto
.. title string nombre del producto
.. type string autoridad certificadora
.. validate_type string Tipo de validación del certificado. El valor del parámetro es dv, ov o ev
.. csr_required string CSR obligatoria. El valor del parámetro es true o false
.. max_years string Validez máxima del certificado
.. min_san_values int Número mínimo de los SANs
.. max_san_values int Número máximo de los SANs

  
{
    "products": [
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-standard-ssl",
            "type": "DigiCert",
            "title": "Standard SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-wildcard",
            "type": "DigiCert",
            "title": "WildCard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-ev-ssl",
            "type": "DigiCert",
            "title": "EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-geotrust-standard-dv-ssl",
            "type": "GeoTrust",
            "title": "DV SSL",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-geotrust-wildcard-dv",
            "type": "GeoTrust",
            "title": "DV SSL Wildcard",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "rapidssl-rapidssl-dv",
            "type": "RapidSSL",
            "title": "RapidSSL DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-client-premium-class-1",
            "type": "DigiCert",
            "title": "Client Premium Class 1",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-ssl",
            "type": "DigiCert",
            "title": "Secure Site SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-123-dv",
            "type": "Thawte",
            "title": "SSL 123 DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-client-premium-class-2",
            "type": "DigiCert",
            "title": "Client Premium Class 2",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "rapidssl-rapidssl-wildcard-dv",
            "type": "RapidSSL",
            "title": "RapidSSL Wildcard DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ov",
            "type": "GeoTrust",
            "title": "TrueBusiness ID OV",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ov",
            "type": "Thawte",
            "title": "SSL Webserver OV",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ssl",
            "type": "DigiCert",
            "title": "Secure Site Pro SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ov-wildcard",
            "type": "Thawte",
            "title": "SSL Webserver OV Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ov-wildcard",
            "type": "GeoTrust",
            "title": "TrueBusiness ID OV Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-individual-500",
            "type": "DigiCert",
            "title": "Document Signing - Individual (500)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-ev-ssl",
            "type": "DigiCert",
            "title": "Secure Site EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ev",
            "type": "GeoTrust",
            "title": "TrueBusiness ID EV",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ev",
            "type": "Thawte",
            "title": "SSL Webserver EV",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-individual-2000",
            "type": "DigiCert",
            "title": "Document Signing - Individual (2000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ev-ssl",
            "type": "DigiCert",
            "title": "Secure Site Pro EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-organization-2000",
            "type": "DigiCert",
            "title": "Document Signing Organization (2000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "client_certificate",
            "product_code": "quovadis-rsassa-pss-smime",
            "type": "QuoVadis",
            "title": "RSASSA-PSS S/MIME",
            "validate_type": "qv",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-wildcard-ssl",
            "type": "DigiCert",
            "title": "Secure Site Wildcard SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-organization-5000",
            "type": "DigiCert",
            "title": "Document Signing Organization (5000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ssl-wildcard",
            "type": "Digicert",
            "title": "Secure Site Pro Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        }
    ]
}
 

La función sirve para introducir el pedido en la cuenta de cliente en cuestión.

POST /order/certificate/{{PRODUCT_CODE}}
  • {{PRODUCT_CODE}} = código del producto
  • Código del estado de la respuesta HTTP: 201
  • Formato de datos de la petición: application/json
  • Formato de datos de la respuesta: application/json

Parámetros iniciales

Nombre Tipo Obligatorio Descripción
domain string nombre del dominio para el cual será emitido el certificado
dns_names array no Campo de los dominios introducidos en SAN
years int Validez del certificado
csr string sí* CSR request para el certificado
voucher string no Cupón descuento
dv_auth_method string no Forma de validación del titular del dominio. Se aceptan los valoresEmail, FILE o DNS. El valor inicial es Email
owner_name string nombre del titular del certificado
owner_street string calle del titular del certificado
owner_city string ciudad del titular del certificado
owner_zip string ano código postal del titular del certificado
owner_country string código de dos letras del titular del certificado (ISO 3166-1 alpha-2)
owner_tel string teléfono del titular del certificado en el formato +34.954112554
auth_title string
auth_firstname string nombre del titular del certificado
auth_lastname string ano apellidos del titular del certificado
auth_tel string teléfono del titular del certificado en el formato +34.954112554
auth_email string correo electrónico del titular del certificado
tech_title string
tech_firstname string nombre de la persona técnica del certificado
tech_lastname string ano apellidos de la persona técnica del certificado
tech_email string ano correo electrónico de la persona técnica del certificado
tech_tel string ano teléfono de la persona técnica del certificado en el formato +34.954112554
invoice_name string nombre de facturación del sujeto del certificado
invoice_street string ano calle de facturación del sujeto del certificado
invoice_city string ano ciudad de facturación del sujeto del certificado
invoice_zip string ano código postal de facturación del sujeto del certificado
invoice_country string código de facturación de dos letras del país del sujeto del certificado (ISO 3166-1 alpha-2)
invoice_email string correo electrónico de facturación del sujeto del certificado
invoice_ic string no NIF de facturación del sujeto del certificado
invoice_dic string ne NIF-IVA de facturación del sujeto del certificado

* Depende del tipo del certificado

Parámetros finales

El número del pedido es una identificación interna utilizada en la administración de SSLmarket; lo puede utilizar en la búsqueda.

Nombre Tipo Descripción
order_id int Número del pedido

La función listará los pedidos en la cuenta cliente en cuestión.

GET /order/list
  • Código del estado HTTP de la respuesta: 200
  • Formato de datos de la respuesta: application/json

Parámetros finales

Nombre Tipo Descripción
orders array Campo de los pedidos
.. order_id int Número del pedido
.. product_type string Tipo del producto
.. product_code string Código del producto
.. domain string nombre del dominio para el cual será emitido el certificado
.. dns_names array Campo de los dominios introducidos en SAN
.. sans_order_count int Número de los SANs introducidos en el pedido
.. years int Validez del certificado
.. inserted datetime Fecha y hora de la introducción del pedido
.. published datetime Fecha y hora de la emisión del certificado
.. expired date Fecha del fin de la validez del certificado

La función mostrará el detalle de un pedido concreto del certificado, que puede encontrar también en la administración de cliente.

GET /order/order_id/{{ORDER_ID}}
  • {{ORDER_ID}} = número del pedido
  • Código del estado HTTP de la respuesta: 200
  • Formato de datos de la respuesta: application/json

Parámetros finales

Nombre Tipo Descripción
product_type string Tipo del producto
product_code string Código del producto
domain string nombre del dominio para el cual será emitido el certificado
dns_names array Campo de los dominios introducidos en SAN
sans_order_count int Número de los SANs introducidos en el pedido
years int Validez del certificado
csr string CSR request para el certificado
owner_name string nombre y apellidos del titular del certificado
owner_street string calle del titular del certificado
owner_city string ciudad del titular del certificado
owner_zip string código postal del titular del certificado
owner_country string código de dos letras del país del titular del certificado (ISO 3166-1 alpha-2)
owner_tel string teléfono del titular del certificado en el formato +34.954112554
auth_title string
auth_firstname string nombre de la persona autorizadora del certificado
auth_lastname string apellidos de la persona autorizadora del certificado
auth_tel string teléfono de la persona autorizadora del certificado en el formato +34.954112554
auth_email string correo electrónico de la persona autorizadora del certificado
tech_title string
tech_firstname string nombre de la persona técnica del certificado
tech_lastname string apellidos de la persona técnica del certificado
tech_email string correo electrónico de la persona técnica del certificado
tech_tel string teléfono de la persona técnica del certificado en el formato +34.954112554
inserted datetime Fecha y hora de la introducción del pedido
published datetime Fecha y hora de la emisión del certificado
expired date Fecha del fin de la validez del certificado
dv_auth_method string Forma de validación del titular del dominio. El parámetro está incluido en la respuesta solamente siproduct_type=ssl_certificate
dv_auth_content string El valor único para validación del titular del dominio. El parámetro está incluido en la respuesta solamente si product_type=ssl_certificate y dv_auth_method=DNS o dv_auth_method=FILE

La función sirve para reemitir el certificado y emitirlo de nuevo. Se utiliza típicamente cuando se pierde la clave privada y es gratuita. El certificado emitido después de la reemisión tiene los mismos parámetros y fecha de expiración que el certificado original.

POST /certificate/order_id/{{ORDER_ID}}/reissue
  • {{ORDER_ID}} = número del pedido
  • Formato de datos de la petición: application/json
  • Código del estado HTTP de la respuesta: 202

Parámetros iniciales

Nombre Obligatorios Tipo Descripción
csr string CSR request para el certificado

La función de revocación del certificado invalidará el certificado de manera permanente y no podrá seguir utilizándolo. La revocación significa perder el certificado sin recompensa y sirve para los casos de un mal uso (comprometimiento) de la clave privada del certificado.

PUT /certificate/order_id/{{ORDER_ID}}/revoke
  • Disponible solamente para los productos DigiCert Client Premium Class 1 y Client Premium Class 2
  • {{ORDER_ID}} = número del pedido
  • Código del estado HTTP de la respuesta: 202

La función sirve para descargar el certificado emitido en el formato elegido, que especificará en el parámetro inicial {{FORMAT}}. PEM es un formato de texto del certificado en Base64 y P7B al contrario es un formato binario.

GET /certificate/order_id/{{ORDER_ID}}/format/{{FORMAT}}
  • {{ORDER_ID}} = número del pedido
  • {{FORMAT}} = formato del certificado
    • pem_server: devuelve el certificado final (de servidor, leaf) en el formato de texto Base64.
    • pem_intermediate: junto con el certificado final devuelve también el certificado intermediate, que es su emisor. Es necesario para la instalación del certificado. Este formato es apropiado para Apache, Nginx y en general, para los servidores Linux.
    • p7b: devuelve el certificado final (de servidor) junto con su chain (intermediate + certificado raíz) en el formato binario P7B (PKCS#7).
  • Código del estado HTTP de la respuesta: 200
  • Formato de datos de la respuesta: text/plain
záchranný kruh sslmarket

¿Muchas preguntas?

Nos alegrará ayudarle con el uso de la API o conocer su opinión. No dude en hacernos saber.

Escríbanos
info@sslmarket.es
Formulario de contacto
Llámenos
+34 900.64.96.55