order_details

QUERY
https://www.digicert.com/services/v2/reports/query

Use esta consulta a fin de obtener información concreta sobre todos los pedidos de certificados.

Para obtener información concreta sobre un pedido de certificado único, use la consulta order_details_by_id.

GraphQL
{
    order_details(valid_till:"2020-10-26",limit:5,sort:["valid_from","DESC"]) {
        id
        common_name
        dns_names
        organization_id
        status
        valid_from
        valid_till
    }
}
200 OK
{
    "data": {
        "order_details": [
            {
                "id": "123456",
                "common_name": "digicert.com",
                "dns_names": null,
                "organization_id": "112233",
                "status": "issued",
                "valid_from": "2019-10-04",
                "valid_till": "2020-10-08"
            },
            {
                "id": "123458",
                "common_name": "dev.digicert.com",
                "dns_names": null,
                "organization_id": "223344",
                "status": "issued",
                "valid_from": "2019-10-03",
                "valid_till": "2020-10-07"
            },
            {
                "id": "123443",
                "common_name": "example.com",
                "dns_names": "sub.example.com,www.example.com",
                "organization_id": "112233",
                "status": "revoked",
                "valid_from": "2019-10-02",
                "valid_till": "2020-10-06"
            },
            {
                "id": "123460",
                "common_name": "example.net",
                "dns_names": "www.example.net",
                "organization_id": "112233",
                "status": "issued",
                "valid_from": "2019-09-30",
                "valid_till": "2020-10-07"
            },
            {
                "id": "123424",
                "common_name": "example.org",
                "dns_names": "test.example.org,monitor.example.org,api.example.org",
                "organization_id": "334455",
                "status": "issued",
                "valid_from": "2019-09-27",
                "valid_till": "2020-10-01"
            }
        ]
    }
}

Argumentos

Incluya argumentos de consulta para filtrar, buscar o manipular información. Separe los diversos argumentos con comas. Salvo ordenar,, todos los argumentos tienen un formato clave:valor (por ejemplo, status:"issued").

Filtros

Use argumentos de filtros para acotar la información que surge de la consulta con los valores de parámetros determinados. Puede usar muchos filtros para acotar aún más los resultados.

Nombre Solicitud/opción Tipo Descripción
id opcional int Id. del pedido.
status opcional string Estado del pedido.
Vea Glosario: estado del pedido
valid_from opcional string Fecha en la que comienza la validez del certificado.
Formato: yyyy-MM-dd
Operador: >=
valid_till opcional string Fecha en la que termina la validez del certificado.
Formato: yyyy-MM-dd
Operador: <=
container_id opcional string Id. de contenedor.
organization_id opcional string Id. de organización.
product_name_id opcional string Id. de nombre del producto.
Vea Glosario: identificadores de productos
serial_number opcional string Número de serie del certificado.
signature_hash opcional string Cifrado de firma usado para firmar la solicitud de certificado.
user_id opcional string Id. del usuario que hizo el pedido.
date_created opcional string Fecha en la que se hizo el pedido.
Formato: yyyy-MM-dd HH:mm:ss
Operador: >=
ca_cert_id opcional string Id. de la autoridad de certificado emisora.
common_name opcional string Nombre que el certificado protege.
Use % para un operador like (por ejemplo, common_name:"%example.com").
dns_names opcional string Lista de nombres adicionales que el certificado protege.
locale opcional string Configuración regional del pedido.
Vea Glosario: códigos de configuración regional
thumbprint opcional string Huella digital del certificado.
email opcional string Correo electrónico del pedido del cliente.

Buscar

Use el argumento de búsqueda para encontrar una cadena determinada contenida en los campos en los que se hizo la búsqueda.

Nombre Solicitud/opción Tipo Descripción
search opcional string Busque campos concretos en la cadena incluida.
Use % para un operador like (por ejemplo, search:"%example.com").
Campos en los que se hizo la búsqueda: id, status, container_id, organization_id, product_name_id, additional_emails, organization_name, product_name, serial_number, user_id, common_name, email

Orden y paginación

Use los argumentos de orden y paginación para manipular los resultados de consulta que se devuelven.

Nombre Solicitud/opción Tipo Descripción
ordenar opcional matriz Indique el campo ordenar y la dirección.
Formato: ["{{field}}","{{direction}}"]
Valores permitidos (campo): valid_till, container_id, organization_id, product_name_id, serial_number, signature_hash, user_id, date_created, ca_cert_id, common_name, dns_names, locale, thumbprint, email
Valores permitidos (dirección): ASC, DESC
Predeterminado: ["id","DESC"]
offset opcional int Comenzar lista en el número especificado para la paginación.
Predeterminado: 0
limit opcional int Truncar lista para el número especificado para la paginación.
Máx.: 1000(predeterminado)

Campos

Debe incluir al menos un campo en la solicitud. Si no se envían campos, se devolverá un error de sintaxis.

Si no existe información para el campo, se devuelve un valor de null.

Nombre Tipo Descripción
account_id string Id. de la cuenta vinculada con el pedido.
additional_emails string Direcciones de correo electrónico adicionales que figuran en el pedido.
agreement_id string Id. de la CSA acordada.
auto_renew string Especifique si el certificado debe renovarse automáticamente.
Posibles valores: 0 (deshabilitada), 1 (habilitada)
ca_cert_id string Id. de la autoridad de certificado emisora.
certificate_tracker_id string Id. de certificado.
common_name string Nombre que el certificado protege.
contacts_email string Dirección de correo electrónico del contacto de la organización.
container_id string Id. del contenedor del pedido.
container_name string Nombre del contenedor del pedido.
cost string Costo del pedido.
csr string Solicitud de firma del certificado (CSR).
custom_renewal_message string Mensaje personalizado incluido en las notificaciones de renovación.
customer_order_id string Id. del pedido del cliente.
date_created string Fecha en la que se hizo el pedido.
Formato: yyyy-MM-dd HH:mm:ss
dcv_method string Método de validación de control de dominio configurado para el dominio.
Vea Glosario: método DCV
disable_issuance_email string Especifica si se envían los correos electrónicos de emisión.
Posibles valores: 0 (falso), 1 (verdadero)
disable_renewal_notifications string Especifica si las notificaciones de renovación están habilitadas.
Posibles valores: 0 (falso), 1 (verdadero)
dns_names string Lista separada por comas de nombres adicionales con protección por el certificado.
email string Si el certificado tiene una dirección de correo electrónico incrustada (por ejemplo, certificados del cliente), devuelve la dirección de correo electrónico en el certificado.
firstname string Nombre del contacto de la organización.
has_duplicates int Especifica si el certificado tiene duplicados.
Posibles valores: 0 (falso), 1 (verdadero)
id string Id. del pedido.
is_out_of_contract string Estado del contrato del pedido.
Posibles valores: 0 (falso), 1 (verdadero)
is_renewed string Especifica si el pedido se ha renovado.
Posibles valores: 0 (falso), 1 (verdadero)
issuer_common_name string Nombre descriptivo de la autoridad de certificado emisora.
job_title string Cargo del contacto de la organización.
lastname string Apellido del contacto de la organización.
locale string Configuración regional del pedido.
Vea Glosario: códigos de configuración regional
metadatos cadena Detalles de los campos personalizados.
Formato: {{metadata_id}} {{metadata_label}} {{metadata_value}}Separador de datos: 0x1f
org_addr1 string Dirección de la organización.
org_addr2 string
organization_city string Ciudad donde se encuentra la organización.
organization_country string País donde se encuentra la organización.
organization_id string Id. de la organización vinculada con el pedido.
organization_name string Nombre de la organización.
organization_state string Estado donde se encuentra la organización.
organization_unit string Unidades de organización que figuran en el certificado.
pay_type string Método de pago usado para el pedido.
Posibles valores: A (saldo de la cuenta), C (tarjeta de crédito)
plus_feature string Especifica si la función más está habilitada para el pedido.
Posibles valores: 0 (deshabilitada), 1 (habilitada)
product_id string Id. del producto.
product_name string Mostrar nombre del producto.
Vea Glosario: identificadores de productos
product_name_id string Id. de nombre del producto.
Vea Glosario: identificadores de productos
product_type string Tipos de producto.
Vea Glosario: tipos de productos
purchased_dns_names string Cantidad de SAN adicionales adquiridos.
receipt_id string Id. del recibo.
Renewed string Especifica si el pedido se ha renovado.
Posibles valores: FALSE, TRUE
renewed_order_id string Id. del pedido anterior.
Solo se devuelve si el pedido es una renovación.
serial_number string Número de serie del certificado.
serversw string Id. de plataforma del servidor.
Vea Glosario: plataformas de servidores
signature_hash string Cifrado de firma usado para firmar la solicitud de certificado.
status string Estado del pedido.
Vea Glosario: estado del pedido
telephone string Número de teléfono del contacto de la organización.
thumbprint string Huella digital del certificado.
user_assignments string Id. del usuario asignado al pedido.
user_email string Dirección de correo electrónico del usuario que solicitó el certificado.
user_first_name string Nombre del usuario que solicitó el certificado.
user_id string Id. del usuario que hizo el pedido.
user_last_name string Apellido del usuario que solicitó el certificado.
valid_from string Fecha en la que comienza la validez del certificado.
Formato: yyyy-MM-dd
valid_till string Fecha en la que termina la validez del certificado.
Formato: yyyy-MM-dd
validity_years string La cantidad de años durante los que el certificado es válido.

Parámetros de la respuesta

Nombre Tipo Descripción
data object Contenedor para la información de la consulta que se devuelve.
.. order_details array Lista de objetos de pedidos que contienen campos consultados.
.. .. {{campo}} - Campo y valor consultados.
Campos devueltos que dependen de la consulta enviada.